LocalFree

指定したローカルメモリオブジェクトを解放し、そのハンドルを無効化する。

LocalFree hMem

hMem : [int] ローカルメモリオブジェクトのハンドル。このハンドルは LocalAlloc または LocalReAlloc 関数によって返される。GlobalAlloc で確保したメモリの解放には使用できない。

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

解説

指定したローカルメモリオブジェクトを解放し、そのハンドルを無効化する。

[戻り値]
関数が成功した場合、戻り値は NULL
である。関数が失敗した場合、戻り値はローカルメモリオブジェクトのハンドルに等しい。拡張エラー情報を取得するには GetLastError
を呼ぶ。

[備考]
プロセスが解放後にそのメモリを参照・変更しようとした場合、ヒープ破壊が発生したり、アクセス違反例外
(EXCEPTION_ACCESS_VIOLATION) が発生したりする可能性がある。hMem 引数が NULL
の場合、LocalFree は引数を無視して NULL を返す。LocalFree
関数はロックされたメモリオブジェクトも解放する。ロックされたメモリオブジェクトはロックカウントが 0 より大きい。LocalLock
関数はローカルメモリオブジェクトをロックし、ロックカウントを 1 増やす。LocalUnlock 関数はロックを解除し、ロックカウントを
1 減らす。ローカルメモリオブジェクトのロックカウントを得るには LocalFlags
関数を使う。アプリケーションがシステムのデバッグバージョンで動作している場合、LocalFree
はロック中のオブジェクトが解放されたことを知らせるメッセージを出力する。アプリケーションをデバッグ中の場合、LocalFree
はロック中のオブジェクトを解放する直前にブレークポイントに入る。これにより意図した動作を確認した上で実行を続行できる。

情報