指定したプロセスによって割り当てられた最初のヒープに関する情報を取得します。
構文
BOOL Heap32ListFirst(
[in] HANDLE hSnapshot,
[in, out] LPHEAPLIST32 lphl
);
パラメーター
[in] hSnapshot
CreateToolhelp32Snapshot 関数の前の呼び出しから返されたスナップショットへのハンドル。
[in, out] lphl
HEAPLIST32構造体へのポインター。
戻り値
ヒープ リストの最初のエントリがバッファーにコピーされた場合は TRUE 、それ以外の場合は FALSE を 返します。 ERROR_NO_MORE_FILES エラー値は、ヒープ リストが存在しないか、スナップショットにヒープ リスト情報が含まれていない場合に、GetLastError 関数によって返されます。
注釈
呼び出し元のアプリケーションでは、HEAPLIST32 の dwSize メンバーを構造体のサイズ (バイト単位) に設定する必要があります。 Heap32ListFirst は 、dwSize を構造体に書き込まれたバイト数に変更します。 これは dwSize の初期値を超えることはありませんが、小さい場合があります。 値が小さい場合は、オフセットがこの値より大きいメンバーの値に依存しないでください。
ヒープ リスト内の他のヒープに関する情報を取得するには、 Heap32ListNext 関数を使用します。
例
例については、「 ヒープ リストの走査」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | tlhelp32.h |
| Library | Kernel32.lib |
| [DLL] | Kernel32.dll |