Share via

IOleCache2::UpdateCache メソッド (oleidl.h)

  • [アーティクル]

指定したキャッシュを更新します。 このメソッドは、アプリケーションでキャッシュを正確に制御する必要がある場合に使用されます。

構文

HRESULT UpdateCache(
  [in] LPDATAOBJECT pDataObject,
  [in] DWORD        grfUpdf,
  [in] LPVOID       pReserved
);

パラメーター

[in] pDataObject

キャッシュの更新元のデータ オブジェクト上の IDataObject インターフェイスへのポインター。 オブジェクト ハンドラーとインプロセス サーバーは、通常、NULL 以外の値を渡します。 コンテナー アプリケーションは通常 NULL を渡し、ソースは現在実行中の オブジェクトから取得されます。

[in] grfUpdf

更新するキャッシュの種類。 このパラメーターには、次の 1 つ以上の値を指定できます。

値 意味
UPDFCACHE_NODATACACHE
IOleCache::Cache の呼び出しでADVF_NODATAを使用して作成されたキャッシュを更新します。
UPDFCACHE_ONSAVECACHE
IOleCache::Cache の呼び出しでADVFCACHE_ONSAVEを使用して作成されたキャッシュを更新します。
UPDFCACHE_ONSTOPCACHE
IOleCache::Cache の呼び出しでADVFCACHE_ONSTOPを使用して作成されたキャッシュを更新します。
UPDFCACHE_NORMALCACHE
 キャッシュを動的に更新します (オブジェクトが OnDataChange 通知を送信するときに通常行われるように)。
UPDFCACHE_IFBLANK
 指定された他のフラグに関係なく、空の場合はキャッシュを更新します。
UPDFCACHE_ONLYIFBLANK
 空のキャッシュのみを更新します。
IFBLANKORONSAVECACHE をUPDFCACHE_する
 OR 操作を使用してUPDFCACHE_IFBLANKとUPDFCACHE_ONSAVECACHEを組み合わせるのと同じです。
UPDFCACHE_ALL
 すべてのキャッシュを更新します。
ALLBUTNODATACACHE をUPDFCACHE_する
 IOleCache::Cache の呼び出しで ADVF_NODATA で作成されたものを除くすべてのキャッシュを更新します。 したがって、ADVF_NODATA フラグを使用して作成されたキャッシュの更新を制御し、これらのキャッシュのみを明示的に更新できます。

[in] pReserved

このパラメーターは予約されており、 NULL である必要があります。

戻り値

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

リターン コード 説明
E_INVALIDARG
 引数の 1 つが無効です。
E_UNEXPECTED
 予期しないエラーが発生しました。
E_OUTOFMEMORY
 この操作で使用できるメモリが不足しています。
OLE_E_NOTRUNNING
 指定した pDataObject が実行されていません。
CACHE_E_NOCACHE_UPDATED
 どのキャッシュも更新されませんでした。
CACHE_S_SOMECACHES_NOTUPDATED
 一部のキャッシュが更新されました。

要件

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

こちらもご覧ください

Idataobject

IOleCache

IOleCache2

IOleCacheControl