指定したローカル メモリ オブジェクトを破棄します。 メモリ オブジェクトのロックカウントは 0 である必要があります。
手記 ローカル関数はオーバーヘッドが大きく、他のメモリ管理機能よりも機能が少なくなります。 ドキュメントでローカル関数を使用する必要がある場合を除き、新しいアプリケーションでは ヒープ 関数を使用する必要があります。 詳細については、「 グローバル関数とローカル関数」を参照してください。
構文
HLOCAL LocalDiscard(
[in] HLOCAL h
);
パラメーター
[in] h
ローカル メモリ オブジェクトへのハンドル。 このハンドルは、 LocalAlloc または LocalReAlloc 関数によって返されます。
戻り値
型: HLOCAL
関数が成功した場合、戻り値はローカル メモリ オブジェクトへのハンドルです。関数が失敗した場合、戻り値は NULL です。 拡張エラー情報を取得するには、GetLastError
注釈
LocalDiscard はオブジェクトのメモリ ブロックを破棄しますが、オブジェクトへのハンドルは有効なままです。 その後、プロセスは LocalReAlloc 関数にハンドルを渡して、同じハンドルによって識別される別のローカル メモリ オブジェクトを割り当てることができます。
要求事項
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | minwinbase.h (Windows.h を含む) |