GlobalDiscard マクロ (winbase.h)

指定したグローバル メモリ ブロックを破棄します。 メモリ オブジェクトのロックカウントは 0 である必要があります。

メモ グローバル関数はオーバーヘッドが大きく、他のメモリ管理機能よりも機能が少なくなります。 新しいアプリケーションでは、グローバル 関数 を使用する必要があるとドキュメントに記載されていない限り、ヒープ関数を使用する必要があります。 詳細については、「 グローバル関数とローカル関数」を参照してください。
 

構文

void GlobalDiscard(
  [in]  h
);

パラメーター

[in] h

グローバル メモリ オブジェクトへのハンドル。 このハンドルは、GlobalAlloc 関数または GlobalReAlloc 関数によって返されます。

戻り値

なし

解説

GlobalDiscard はオブジェクトのメモリ ブロックを破棄しますが、オブジェクトへのハンドルは有効なままです。 その後、プロセスはハンドルを GlobalReAlloc 関数に渡して、同じハンドルによって識別される別のグローバル メモリ ブロックを割り当てることができます。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)

関連項目

グローバル関数とローカル関数

GlobalAlloc

GlobalReAlloc

メモリ管理関数