<Return[H]><Top>

HeapDestroy

Declare Function Api_HeapDestroy& Lib "kernel32" Alias "HeapDestroy" (ByVal hHeap&)

Declare Function HeapDestroy Lib "kernel32" Alias "HeapDestroy" (ByVal hHeap As Long) As Long

指定されたヒープオブジェクトを破棄する。プライベートヒープオブジェクトのすべてのページのコミットを解除してページを解放し、ヒープのハンドルを無効にする。

パラメータ
hHeap
    [入力]破棄したいヒープのハンドルを指定する。このパラメータでは、HeapCreate 関数が返したハンドルを指定するべきである。

    GetProcessHeap 関数が返したハンドルを指定しない。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、 関数を使う。

解説
    ヒープから割り当て済みのメモリを解放する場合、最初に HeapFree 関数を呼び出すことなく、直接 HeapDestroy 関数を呼び出すこともで

    きる。