HeapDestroy

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

HeapDestroy hHeap

hHeap : [intptr] 破棄するヒープへのハンドル。HeapCreate で取得する。GetProcessHeap が返すプロセスヒープへのハンドルを使ってはならない。

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

解説

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

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

[備考]
プロセスはヒープから割り当てたメモリを先に HeapFree で解放しなくても HeapDestroy を呼び出すことができる。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs