IOleLink::Perbarui metode (oleidl.h)

Artikel
03/21/2023
2 menit untuk membaca

Updates data singgahan dokumen campuran untuk objek tertaut. Ini melibatkan pengikatan ke sumber tautan, jika belum terikat.

Sintaks

HRESULT Update(
  [in] IBindCtx *pbc
);

Parameter

[in] pbc

Penunjuk ke antarmuka IBindCtx pada konteks ikatan yang akan digunakan dalam mengikat sumber tautan. Parameter ini bisa NULL. Konteks ikatan menyimpan objek yang terikat selama proses pengikatan, berisi parameter yang berlaku untuk semua operasi menggunakan konteks ikatan, dan menyediakan sarana di mana implementasi pengikatan harus mengambil informasi tentang lingkungannya. Untuk informasi selengkapnya, lihat IBindCtx.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
CACHE_E_NOCACHE_UPDATE	Operasi pengikatan bekerja tetapi tidak ada cache yang diperbarui.
CACHE_S_SOMECACHES_NOTUPDATED	Operasi pengikatan bekerja tetapi tidak semua cache diperbarui.
OLE_E_CANT_BINDTOSOURCE	Tidak dapat mengikat ke sumber tautan.

Keterangan

Catatan untuk Penelepon

Aplikasi kontainer Anda harus memanggil Perbarui jika pengguna akhir memperbarui data cache untuk objek tertaut.

Pengguna akhir dapat memperbarui data cache untuk objek tertaut dengan memilih tombol Perbarui Sekarang dalam kotak dialog Tautan . Jika Anda menggunakan fungsi OleUIEditLinks untuk menampilkan kotak dialog Tautan , Anda harus menerapkan antarmuka IOleUILinkContainer . Kotak dialog memanggil implementasi IOleUILinkContainer::UpdateLink saat pengguna akhir memilih tombol Perbarui Sekarang . Implementasi Anda dari metode tersebut dapat memanggil Perbarui.

Aplikasi kontainer Anda juga dapat memanggil Pembaruan untuk memperbarui objek yang ditautkan, karena metode tersebut memanggil Perbarui saat dipanggil pada objek tertaut.

Metode ini memperbarui tautan otomatis dan tautan manual. Untuk tautan manual, memanggil Pembaruan atau Pembaruan adalah satu-satunya cara untuk memperbarui cache. Untuk informasi selengkapnya tentang tautan otomatis dan manual, lihat IOleLink::SetUpdateOptions.

Catatan tentang Implementasi

Jika pbc bukan NULL, implementasi pembaruan objek yang ditautkan memanggil IBindCtx::RegisterObjectBound untuk mendaftarkan sumber tautan terikat. Ini memastikan bahwa sumber tautan tetap berjalan sampai konteks ikatan dirilis.

Cache saat ini dibiarkan utuh jika sumber tautan tidak dapat diikat.

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	oleidl.h