HeapQueryInformation

指定したヒープに関する情報を取得する。

HeapQueryInformation HeapHandle, HeapInformationClass, HeapInformation, HeapInformationLength, ReturnLength

HeapHandle : [intptr] 情報を取得するヒープへのハンドル。このハンドルは HeapCreate もしくは GetProcessHeap 関数によって返される。
HeapInformationClass : [int] 取得する情報のクラス。このパラメータには HEAP_INFORMATION_CLASS 列挙型の次の値を指定できる。
HeapInformation : [intptr] ヒープ情報を受け取るバッファへのポインタ。このデータの形式は HeapInformationClass パラメータの値によって異なる。
HeapInformationLength : [int] 問い合わせるヒープ情報のサイズ（バイト単位）。
ReturnLength : [var] HeapInformation バッファに書き込まれたデータの長さを受け取る変数へのポインタ。バッファが小さすぎる場合、関数は失敗し、ReturnLength にはバッファに必要な最小サイズが設定される。

(プラグイン / モジュール : kernel32.dll)

解説

指定したヒープに関する情報を取得する。

[戻り値]
関数が成功した場合、戻り値は 0 以外となる。関数が失敗した場合、戻り値は 0 となる。拡張エラー情報を取得するには
GetLastError を呼ぶ。

[備考]
LFH や terminate-on-corruption 機能を有効にするには HeapSetInformation
関数を使う。Windows XP と Windows Server 2003
では、ルックアサイドリストは固定サイズのブロックのみを持つ高速なメモリ確保機構である。サポートするヒープに対してルックアサイドリストは既定で有効になっている。Windows
Vista 以降ではルックアサイドリストは使われず、LFH
が既定で有効になっている。ルックアサイドリストは、サイズが可変な一般プール確保よりも高速である。システムが確保サイズに合う空きメモリを探さないためである。さらに、ルックアサイドリストへのアクセスは通常、ミューテックスやスピンロックではなく高速なアトミック
プロセッサ交換命令で同期される。ルックアサイドリストはシステムまたはドライバによって作成でき、ページドプールまたは非ページドプールから確保できる。

情報