CreateDataCache 函式 (objbase.h)

擷取資料快取之 OLE 所提供實作之新實例的指標。

語法

HRESULT CreateDataCache(
  [in]  LPUNKNOWN pUnkOuter,
  [in]  REFCLSID  rclsid,
  [in]  REFIID    iid,
  [out] LPVOID    *ppv
);

[in] pUnkOuter

如果要將快取建立為匯總的一部分，則指向控制匯總之 IUnknown 的指標。如果沒有，參數應該是 Null。

[in] rclsid

用來產生圖示標籤的 CLSID。此值通常是CLSID_Null。

[in] iid

呼叫端想要用來與快取通訊之介面識別碼的參考。此值通常會 IID_IOleCache (在 OLE 標頭中定義，以等於 IOleCache) 的介面識別碼。

[out] ppv

接收 riid 中要求的介面指標的指標變數位址。成功傳回時，*ppvObj 包含所提供快取物件的要求介面指標。

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

傳回碼	描述
E_NOINTERFACE	物件不支援 riid 所表示的介面。 ppvObj參數會設定為Null。
E_OUTOFMEMORY	作業的記憶體不足。
E_INVALIDARG	一或多個參數無效。

CreateDataCache所建立的快取物件支援IOleCache、IOleCache2和IOleCacheControl介面來控制快取。它也支援IPersistStorage、IDataObject (，而不建議接收) 、IViewObject 和 IViewObject2介面。