IOleObject::Metode GetMoniker (oleidl.h)

Artikel
03/01/2024

Mengambil moniker objek yang disematkan, yang dapat digunakan pemanggil untuk menautkan ke objek.

Sintaks

HRESULT GetMoniker(
  [in]  DWORD    dwAssign,
  [in]  DWORD    dwWhichMoniker,
  [out] IMoniker **ppmk
);

Parameter

[in] dwAssign

Menentukan bagaimana moniker ditetapkan ke objek . Bergantung pada nilai dwAssign, IOleObject::GetMoniker melakukan salah satu hal berikut ini:

Mendapatkan moniker hanya jika satu telah ditetapkan.
Memaksa penugasan moniker, jika perlu, untuk memenuhi panggilan.
Mendapatkan moniker sementara.

Nilai untuk dwAssign ditentukan dalam enumerasi OLEGETMONIKER.

Catatan Anda tidak dapat melewati OLEGETMONIKER_UNASSIGN saat memanggil IOleObject::GetMoniker. Nilai ini hanya valid saat memanggil IOleObject::GetMoniker.

[in] dwWhichMoniker

Menentukan bentuk moniker yang diminta. Nilai yang mungkin diambil dari enumerasi OLEWHICHMK.

[out] ppmk

Alamat variabel penunjuk IMoniker yang menerima penunjuk antarmuka ke moniker objek. Jika terjadi kesalahan, ppmk harus diatur ke NULL. Setiap kali objek menerima panggilan ke IOleObject::GetMoniker, objek harus meningkatkan jumlah referensi pada ppmk. Pemanggil bertanggung jawab untuk memanggil Rilis ketika dilakukan dengan ppmk.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Metode IOleObject::GetMoniker mengembalikan moniker objek. Seperti IOleObject::SetMoniker, metode ini hanya penting dalam konteks mengelola tautan ke objek yang disematkan dan bahkan dalam hal ini bersifat opsional. Klien tautan potensial yang memerlukan moniker objek untuk mengikat objek dapat memanggil metode ini untuk mendapatkan moniker tersebut. Implementasi default IOleObject::GetMoniker memanggil IOleClientSite::GetMoniker, mengembalikan E_UNEXPECTED jika objek tidak berjalan atau tidak memiliki penunjuk yang valid ke situs klien.

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