Metode IOleUILinkContainerA::UpdateLink (oledlg.h)

  • Artikel

Memaksa tautan yang dipilih untuk tersambung ke sumbernya dan mengambil informasi saat ini.

Sintaks

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Parameter

[in] dwLink

Pengidentifikasi unik yang ditentukan kontainer untuk satu tautan. Kontainer dapat menggunakan penunjuk ke situs kontainer tautan untuk nilai ini.

[in] fErrorMessage

Menentukan apakah pemanggil (pelaksana IOleUILinkContainer) harus menampilkan pesan kesalahan saat gagal memperbarui tautan. Kotak dialog Perbarui Tautan mengatur ini ke FALSE. Kotak dialog Properti Objek dan Tautan mengaturnya ke TRUE.

[in] fReserved

Parameter ini dicadangkan dan harus diatur ke FALSE.

Nilai kembali

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

Menampilkan kode Deskripsi
E_ACCESSDENIED
 Izin akses tidak cukup.
E_FAIL
 Operasi gagal.
E_INVALIDARG
 Pengidentifikasi yang ditentukan tidak valid.
E_OUTOFMEMORY
 Tidak tersedia cukup memori untuk operasi ini.

Keterangan

Catatan untuk Penelepon

Panggil metode ini dengan fErrorMessage diatur ke TRUE jika pengguna secara tegas menekan tombol untuk memperbarui tautan, yaitu, menekan tombol Perbarui Sekarang tautan. Sebut saja dengan FALSE jika kontainer tidak boleh menampilkan pesan kesalahan, yaitu, di mana serangkaian operasi besar sedang dilakukan dan kesalahan harus disebarluaskan kembali ke pengguna nanti, seperti yang mungkin terjadi dengan meter kemajuan tautan Pembaruan . Daripada memberikan satu pesan untuk setiap kegagalan, dengan asumsi ada kegagalan, berikan satu pesan untuk semua kegagalan di akhir operasi.

Catatan untuk Pelaksana

Untuk tautan OLE, panggil IOleObject::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 oledlg.h

Lihat juga

IOleObject::Update

IOleUILinkContainer