Metode IOleLink::SetSourceMoniker (oleidl.h)

Artikel
08/25/2023

Mengatur moniker untuk sumber tautan.

Sintaks

HRESULT SetSourceMoniker(
  [in] IMoniker *pmk,
  [in] REFCLSID rclsid
);

Parameter

[in] pmk

Penunjuk ke antarmuka IMoniker pada moniker yang mengidentifikasi sumber tautan baru dari objek yang ditautkan. Nilai NULL memutus tautan.

[in] rclsid

CLSID dari sumber tautan yang harus digunakan objek tertaut untuk mengakses informasi tentang objek tertaut ketika tidak terikat.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Catatan untuk Penelepon

Aplikasi kontainer Anda dapat memanggil IOleLink::SetSourceMoniker saat pengguna akhir mengubah sumber tautan atau memutuskan tautan. Perhatikan bahwa ini mengharuskan kontainer Anda untuk menggunakan fungsi MkParseDisplayName untuk membuat moniker dari nama tampilan yang dimasukkan pengguna akhir. Jika Anda lebih suka objek yang ditautkan melakukan penguraian, kontainer Anda dapat memanggil IOleLink::SetSourceDisplayName alih-alih IOleLink::SetSourceMoniker.

Pengguna akhir mengubah sumber tautan atau memutuskan tautan menggunakan kotak dialog Tautan . 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 Anda dari metode ini dapat memanggil IOleLink::SetSourceMoniker.

Jika objek yang ditautkan saat ini terikat ke sumber tautannya, implementasi objek tertaut dari IOleLink::SetSourceMoniker menutup tautan sebelum mengubah moniker.

Catatan untuk Pelaksana

Kontrak IOleLink tidak menentukan bagaimana objek tertaut menyimpan atau menggunakan moniker sumber tautan. Implementasi yang disediakan menyimpan moniker absolut yang ditentukan ketika tautan dibuat atau ketika moniker diubah; kemudian menghitung dan menyimpan moniker relatif. Implementasi di masa mendatang mungkin mengelola moniker secara berbeda untuk memberikan pelacakan moniker yang lebih baik. Moniker absolut menyediakan jalur lengkap ke sumber tautan. Objek yang ditautkan menggunakan moniker absolut ini dan moniker dokumen gabungan untuk menghitung moniker relatif yang mengidentifikasi sumber tautan relatif terhadap dokumen campuran yang berisi tautan.

pmkCompoundDoc-RelativePathTo>(pmkAbsolute, ppmkRelative)

Saat mengikat ke sumber tautan, objek yang ditautkan pertama kali mencoba mengikat menggunakan moniker relatif. Jika gagal, ia mencoba mengikat moniker absolut.

Ketika objek yang ditautkan berhasil mengikat menggunakan moniker relatif atau absolut, objek tersebut secara otomatis memperbarui moniker lainnya. Objek yang ditautkan juga memperbarui kedua moniker ketika terikat ke sumber tautan dan menerima pemberitahuan penggantian nama melalui metode IAdviseSink::OnRename . Aplikasi kontainer juga dapat menggunakan metode IOleLink::SetSourceDisplayName untuk mengubah moniker tautan.

Implementasi objek tertaut dari IPersistStorage::Save menyimpan moniker relatif dan absolut.

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