IOleCache2::D iscardCache メソッド (oleidl.h)

  • [アーティクル]

メモリ内のキャッシュを破棄します。

構文

HRESULT DiscardCache(
  [in] DWORD dwDiscardOptions
);

パラメーター

[in] dwDiscardOptions

破棄される前にデータを保存するかどうかを示す DISCARDCACHE 列挙の値。 大きなオブジェクトを描画し、メモリを解放する必要があるコンテナーでは、次にオブジェクトを描画する必要がある場合に最新のプレゼンテーションを保存できるように、DISCARDCACHE_SAVEIFDIRTYを指定できます。

埋め込みオブジェクトをアクティブ化し、いくつかの変更を行った後、 IOleObject::Close を呼び出して変更をロールバックするOLECLOSE_NOSAVEコンテナーでは、DISCARDCACHE_NOSAVEを指定して、ネイティブデータとプレゼンテーション データが同期しないようにすることができます。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な戻り値は次のとおりです。

リターン コード 説明
OLE_E_NOSTORAGE
 キャッシュにデータを保存するために使用できるストレージはありません。
STG_E_MEDIUMFULL
 ストレージ メディアがいっぱいです。

注釈

IOleCache2::D iscardCache メソッドは、プレゼンテーション キャッシュで現在使用されているメモリを解放することで、メモリ不足の状態を処理するために一般的に使用されます。

破棄された後、キャッシュはディスク ベースのデータに戻すことによって、後続の IDataObject::GetData 呼び出しを満たします。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー oleidl.h

こちらもご覧ください

IOleCache

IOleCache2

IOleCacheControl