プロセスによって割り当てられたヒープの次のブロックに関する情報を取得します。
構文
BOOL Heap32Next(
[out] LPHEAPENTRY32 lphe
);
パラメーター
[out] lphe
HEAPENTRY32構造体へのポインター。
戻り値
ヒープ内の次のブロックに関する情報がバッファーにコピーされた場合は TRUE 、それ以外の場合は FALSE を 返します。 GetLastError 関数は、ヒープ内にこれ以上オブジェクトが存在しない場合にERROR_NO_MORE_FILESを返し、ヒープが破損しているように見えるか、または Heap32Next を続行できないようにウォーク中に変更された場合にERROR_INVALID_DATAします。
注釈
ヒープの最初のブロックの情報を取得するには、 Heap32First 関数を使用します。
Heap32Next 関数は、ターゲット プロセスへの参照を保持しません。 ターゲット プロセスが終了した場合、システムは同じプロセス識別子を使用して新しいプロセスを作成できます。 したがって、呼び出し元は Heap32Next を使用している限り、ターゲット プロセスへの参照を維持する必要があります。
Heap32First と Heap32Next を使用してヒープを歩くことは、特に大きなヒープでは非効率的です。 代わりに HeapWalk を使用してください。
例
例については、「 ヒープ リストの走査」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | tlhelp32.h |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |