IOleCache2：：UpdateCache 方法 (oleidl.h)

匯報指定的快取。當應用程式需要精確控制快取時，就會使用這個方法。

語法

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

[in] pDataObject

更新快取之數據物件上 IDataObject 介面的指標。對象處理程式和進程內伺服器通常會傳遞非 NULL 值。容器應用程式通常會傳遞 NULL，而且來源是從目前執行中的物件取得。

[in] grfUpdf

要更新的快取類型。此參數可以是下列一或多個值。

值	意義
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	匯報只有空白的快取。
UPDFCACHE_ IFBLANKORONSAVECACHE	使用 OR 作業來結合UPDFCACHE_IFBLANK和UPDFCACHE_ONSAVECACHE的對等專案。
UPDFCACHE_ALL	匯報所有快取。
UPDFCACHE_ ALLBUTNODATACACHE	匯報呼叫 IOleCache：：Cache 中以 ADVF_NODATA 建立的所有快取除外。因此，您可以控制使用 ADVF_NODATA 旗標所建立之快取的更新，並只明確更新這些快取。

[in] pReserved

此參數是保留的，而且必須是 NULL。

此方法會在成功時傳回S_OK。其他可能的傳回值包括下列專案。

傳回碼	Description
E_INVALIDARG	其中一個自變數無效。
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