Metode IOleLink::SetSourceDisplayName (oleidl.h)

Artikel
03/04/2024

Menyetel nama tampilan untuk sumber tautan.

Sintaks

HRESULT SetSourceDisplayName(
  [in] LPCOLESTR pszStatusText
);

Parameter

[in] pszStatusText

Penunjuk ke nama tampilan sumber tautan baru. Parameter ini tidak boleh NULL.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Nilai dari MkParseDisplayName juga dapat dikembalikan di sini.

Keterangan

Catatan untuk Penelepon

Aplikasi kontainer Anda dapat memanggil IOleLink::SetSourceDisplayName saat pengguna akhir mengubah sumber tautan atau memutuskan tautan. Perhatikan bahwa ini memerlukan objek tertaut untuk membuat moniker dari nama tampilan. Jika Anda lebih suka mengurai nama tampilan ke dalam moniker sendiri, kontainer Anda dapat memanggil IOleLink::SetSourceMoniker alih-alih IOleLink::SetSourceDisplayName.

Jika Anda menggunakan fungsi OleUIEditLinks untuk menampilkan kotak dialog Tautan , Anda harus menerapkan antarmuka IOleUILinkContainer . Kotak dialog memanggil implementasi IOleUILinkContainer::SetLinkSource dan IOleUILinkContainer::CancelLink. Implementasi metode ini dapat memanggil IOleLink::SetSourceDisplayName.

Jika aplikasi kontainer Anda segera akan mengikat ke sumber tautan yang baru ditentukan, Anda harus memanggil MkParseDisplayName dan IOleLink::SetSourceMoniker sebagai gantinya, lalu memanggil IOleLink::BindToSource menggunakan konteks ikat dari operasi penguraian. Dengan menggunakan kembali konteks ikatan, Anda dapat menghindari pemuatan objek yang berlebihan yang mungkin terjadi.

Catatan untuk Pelaksana

Kontrak untuk IOleLink::SetSourceDisplayName tidak menentukan kapan objek tertaut akan mengurai nama tampilan menjadi moniker. Penguraian dapat terjadi sebelum IOleLink::SetSourceDisplayName kembali, atau objek tertaut dapat menyimpan nama tampilan dan mengurainya hanya ketika perlu mengikat ke sumber tautan. Perhatikan bahwa mengurai nama tampilan berpotensi merupakan operasi yang mahal karena mungkin memerlukan pengikatan ke sumber tautan. Implementasi IOleLink::SetSourceDisplayName yang disediakan mengurai nama tampilan lalu merilis konteks ikatan yang digunakan dalam operasi penguraian. Ini dapat mengakibatkan berjalan lalu menghentikan server sumber tautan.

Jika objek tertaut terikat ke sumber tautan saat ini, implementasi IOleLink::SetSourceDisplayName memutuskan koneksi.

Untuk informasi selengkapnya tentang cara objek tertaut menyimpan dan menggunakan moniker ke sumber tautan, lihat IOleLink::SetSourceMoniker.

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