IOleLink::Perbarui metode (oleidl.h)

Artikel
08/25/2023

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.

Nilai kembali

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

Menampilkan kode	Deskripsi
CACHE_E_NOCACHE_UPDATE	Operasi pengikatan berfungsi tetapi tidak ada cache yang diperbarui.
CACHE_S_SOMECACHES_NOTUPDATED	Operasi pengikatan berfungsi 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 yang di-cache untuk objek tertaut.

Pengguna akhir dapat memperbarui data yang di-cache untuk objek tertaut dengan memilih tombol Perbarui Sekarang di 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 Pembaruan.

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

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 pbcnon-NULL, implementasi Pembaruan objek yang ditautkan memanggil IBindCtx::RegisterObjectBound untuk mendaftarkan sumber tautan terikat. Ini memastikan bahwa sumber tautan tetap berjalan hingga konteks ikatan dirilis.

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

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