Bagikan melalui

IOleCache2::Metode UpdateCache (oleidl.h)

  • Artikel

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

IDataObject

IOleCache

IOleCache2

IOleCacheControl