LocalDiscard マクロ (minwinbase.h)

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

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

構文

void LocalDiscard(
  [in]  h
);

[in] h

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

なし

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