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 |
|---|---|
|
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 |