Heap32ListFirst

Declare Function Api_Heap32ListFirst& Lib "kernel32" Alias "Heap32ListFirst" (ByVal hSnapshot&, ByRef lphl As HEAPLIST32)

Declare Function Heap32ListFirst Lib "kernel32" Alias "Heap32ListFirst" (ByVal hSnapshot As Long, ByRef lphl As HEAPLIST32) As Long

指定されたプロセスが割り当てた最初のヒープに関する情報を取得する。

パラメータ
hSnapshot
    直前に CreateToolhelp32Snapshot 関数を呼び出したときに返された、スナップショットのハンドルを指定する。
lphl
    HEAPLIST32 構造体のハンドルを指定する。

戻り値
    ヒープリストの最初のエントリがバッファにコピーされた場合は、TRUE が返る。
    それ以外の場合は、FALSE が返る。ヒープリストが存在しなかったりスナップショットにヒープリスト情報が含まれていない場合は、

    GetLastError 関数は ERROR_NO_MORE_FILES エラー値を返す。

解説
    呼び出し側のアプリケーションは、HEAPLIST32 構造体の dwSize メンバを、この構造体のバイト単位のサイズに設定しなければならな

    い。Heap32ListFirst 関数は dwSize メンバを、この構造体に書き込まれたバイト数に変更する。後者の値は、dwSize メンバの最初の値

    を上回ることはないが、それより小さくなることはある。後者の値が最初の値より小さくなっていた場合、後者の値を上回るオフセット値を持

    つメンバの値を信頼してはならない。
    ヒープリスト内の他のヒープに関する情報を取得するには、Heap32ListNext 関数を使う。