IOleLink::GetSourceMoniker method (oleidl.h)

Mengambil moniker yang mengidentifikasi sumber tautan objek yang ditautkan.

Sintaks

HRESULT GetSourceMoniker(
  [out] IMoniker **ppmk
);

Parameter

[out] ppmk

Alamat variabel penunjuk IMoniker yang menerima penunjuk antarmuka ke moniker absolut yang mengidentifikasi sumber tautan. Ketika berhasil, implementasi harus memanggil AddRef pada ppmk; adalah tanggung jawab penelepon untuk memanggil Rilis. Jika terjadi kesalahan, implementasi harus mengatur ppmk ke NULL.

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
MK_E_UNAVAILABLE	Tidak ada moniker yang tersedia.

Keterangan

Catatan untuk Penelepon

Aplikasi kontainer Anda dapat memanggil IOleLink::GetSourceMoniker untuk menampilkan sumber tautan saat ini dalam kotak dialog Tautan . Perhatikan bahwa ini mengharuskan kontainer Anda menggunakan metode IMoniker::GetDisplayName untuk mendapatkan nama tampilan moniker. Jika Anda lebih suka mendapatkan nama tampilan secara langsung, kontainer Anda dapat memanggil IOleLink::GetSourceDisplayName alih-alih IOleLink::GetSourceMoniker.

Jika Anda menggunakan fungsi OleUIEditLinks untuk menampilkan kotak dialog Tautan , Anda harus menerapkan antarmuka IOleUILinkContainer . Kotak dialog memanggil implementasi IOleUILinkContainer::GetLinkSource Anda untuk mendapatkan string yang harus ditampilkan. Implementasi metode tersebut dapat memanggil IOleLink::GetSourceMoniker.

Catatan untuk Pelaksana

Objek yang ditautkan menyimpan moniker absolut dan relatif untuk sumber tautan. Jika moniker relatif non-NULL dan moniker tersedia untuk dokumen gabungan, IOleLink::GetSourceMoniker mengembalikan moniker yang dibuat dengan menyusun moniker relatif ke akhir moniker dokumen gabungan. Jika tidak, ia mengembalikan moniker absolut atau, jika terjadi kesalahan, NULL.

Kontainer menentukan moniker absolut saat memanggil salah satu fungsi OleCreateLink untuk membuat tautan. Aplikasi ini dapat memanggil IOleLink::GetSourceMoniker atau IOleLink::GetSourceDisplayName untuk mengubah moniker absolut. Selain itu, objek tertaut secara otomatis memperbarui moniker setiap kali berhasil mengikat ke sumber tautan, atau ketika terikat ke sumber tautan dan menerima pemberitahuan ganti nama melalui metode IAdviseSink::OnRename .

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

Lihat juga

IOleLink

IOleLink::GetSourceDisplayName

IOleLink::GetSourceMoniker