Fungsi CreateDataCache (objbase.h)

Artikel
08/25/2023

Mengambil pointer ke instans baru dari implementasi cache data yang disediakan OLE.

Sintaks

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

Parameter

[in] pUnkOuter

Jika cache akan dibuat sebagai bagian dari agregat, arahkan ke IUnknown pengontrol agregat. Jika tidak, parameter harus NULL.

[in] rclsid

CLSID digunakan untuk menghasilkan label ikon. Nilai ini biasanya CLSID_NULL.

[in] iid

Referensi ke pengidentifikasi antarmuka yang ingin digunakan pemanggil untuk berkomunikasi dengan cache. Nilai ini biasanya IID_IOleCache (didefinisikan dalam header OLE agar sama dengan pengidentifikasi antarmuka untuk IOleCache).

[out] ppv

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvObj berisi penunjuk antarmuka yang diminta ke objek cache yang disediakan.

Menampilkan nilai

Fungsi ini mengembalikan S_OK pada keberhasilan. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_NOINTERFACE	Antarmuka yang diwakili oleh riid tidak didukung oleh objek . Parameter ppvObj diatur ke NULL.
E_OUTOFMEMORY	Memori untuk operasi tidak cukup.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.

Keterangan

Objek cache yang dibuat oleh CreateDataCache mendukung antarmuka IOleCache, IOleCache2, dan IOleCacheControl untuk mengontrol cache. Ini juga mendukung antarmuka IPersistStorage, IDataObject (tanpa saran sink), IViewObject, dan IViewObject2 .

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	objbase.h
Pustaka	Ole32.lib
DLL	Ole32.dll
Set API	ext-ms-win-com-ole32-l1-1-5 (diperkenalkan dalam Windows 10, versi 10.0.15063)

Lihat juga

IOleCache

IOleCache2

IOleCacheControl

Bagikan melalui