IOleCache2::Metode UpdateCache (oleidl.h)

Artikel
08/25/2023

Updates cache yang ditentukan. Metode ini digunakan ketika aplikasi membutuhkan kontrol yang tepat atas penembolokan.

Sintaks

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

Parameter

[in] pDataObject

Penunjuk ke antarmuka IDataObject pada objek data tempat cache diperbarui. Handler objek dan server dalam proses biasanya melewati nilai non-NULL . Aplikasi kontainer biasanya melewati NULL, dan sumber diperoleh dari objek yang sedang berjalan.

[in] grfUpdf

Jenis cache yang akan diperbarui. Parameter ini bisa menjadi satu atau beberapa nilai berikut.

Nilai	Makna
UPDFCACHE_NODATACACHE	Updates cache yang dibuat dengan menggunakan ADVF_NODATA dalam panggilan ke IOleCache::Cache.
UPDFCACHE_ONSAVECACHE	Updates cache yang dibuat dengan menggunakan ADVFCACHE_ONSAVE dalam panggilan ke IOleCache::Cache.
UPDFCACHE_ONSTOPCACHE	Updates cache yang dibuat dengan menggunakan ADVFCACHE_ONSTOP dalam panggilan ke IOleCache::Cache.
UPDFCACHE_NORMALCACHE	Memperbarui cache secara dinamis (seperti yang biasanya dilakukan ketika objek mengirimkan pemberitahuan OnDataChange ).
UPDFCACHE_IFBLANK	Updates cache jika kosong, terlepas dari bendera lain yang ditentukan.
UPDFCACHE_ONLYIFBLANK	Updates hanya cache yang kosong.
UPDFCACHE_ IFBLANKORONSAVECACHE	Setara dengan menggunakan operasi OR untuk menggabungkan UPDFCACHE_IFBLANK dan UPDFCACHE_ONSAVECACHE.
UPDFCACHE_ALL	Updates semua cache.
UPDFCACHE_ ALLBUTNODATACACHE	Updates semua cache kecuali yang dibuat dengan ADVF_NODATA dalam panggilan ke IOleCache::Cache. Dengan demikian, Anda dapat mengontrol pembaruan pada cache yang dibuat dengan bendera ADVF_NODATA dan hanya memperbarui cache ini secara eksplisit.

[in] pReserved

Parameter ini dicadangkan dan harus NULL.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu argumen tidak valid.
E_UNEXPECTED	Terjadi kesalahan tidak terduga.
E_OUTOFMEMORY	Memori tidak cukup tersedia untuk operasi ini.
OLE_E_NOTRUNNING	pDataObject yang ditentukan tidak berjalan.
CACHE_E_NOCACHE_UPDATED	Tidak ada cache yang diperbarui.
CACHE_S_SOMECACHES_NOTUPDATED	Beberapa cache diperbarui.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h

Lihat juga

Bagikan melalui