Metode IOleLink::SetUpdateOptions (oleidl.h)

Artikel
03/01/2024

Menentukan seberapa sering objek tertaut harus memperbarui data yang di-cache.

Sintaks

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Parameter

[in] dwUpdateOpt

Menentukan seberapa sering objek tertaut harus memperbarui data yang di-cache. Nilai yang mungkin untuk dwUpdateOpt diambil dari enumerasi OLEUPDATE.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Nilai yang disediakan tidak valid.

Keterangan

Catatan untuk Penelepon

Aplikasi kontainer Anda harus memanggil IOleLink::SetUpdateOptions saat pengguna akhir mengubah opsi pembaruan untuk objek yang ditautkan.

Pengguna akhir memilih opsi pembaruan untuk objek tertaut menggunakan kotak dialog Tautan . Jika Anda menggunakan fungsi OleUIEditLinks untuk menampilkan kotak dialog ini, Anda harus menerapkan antarmuka IOleUILinkContainer . Kotak dialog memanggil metode IOleUILinkContainer::SetLinkUpdateOptions Anda untuk menentukan opsi pembaruan yang dipilih oleh pengguna akhir. Implementasi metode ini harus memanggil metode IOleLink::SetUpdateOptions untuk meneruskan opsi yang dipilih ke objek yang ditautkan.

Catatan untuk Pelaksana

Opsi pembaruan default adalah OLEUDPATE_ALWAYS. Implementasi objek tertaut dari IPersistStorage::Save menyimpan opsi pembaruan saat ini.

Jika OLEUDPATE_ALWAYS ditentukan sebagai opsi pembaruan, objek tertaut memperbarui cache tautan dalam situasi berikut:

Saat opsi pembaruan diubah dari manual ke otomatis, jika sumber tautan sedang berjalan.
Setiap kali objek tertaut mengikat ke sumber tautan.
Setiap kali sumber tautan berjalan dan implementasi IOleObject::Close, IPersistStorage::Save, atau IAdviseSink::OnSave objek tertaut dipanggil.

Untuk tautan manual dan otomatis, objek tertaut memperbarui cache setiap kali aplikasi kontainer memanggil IOleObject::Update atau IOleLink::Update.

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