Metode IBindCtx::GetObjectParam (objidl.h)

Artikel
08/25/2023

Mengambil penunjuk antarmuka ke objek yang terkait dengan kunci yang ditentukan dalam tabel penunjuk berkunci string konteks ikatan.

Sintaks

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

Parameter

[in] pszKey

Kunci string konteks ikatan yang akan dicari. Perbandingan string kunci peka huruf besar/kecil.

[out] ppunk

Alamat variabel pointer IUnknown* yang menerima penunjuk antarmuka ke objek yang terkait dengan pszKey. Ketika berhasil, implementasi memanggil AddRef pada *ppunk. Pemanggil bertanggung jawab untuk memanggil Rilis. Jika terjadi kesalahan, implementasi menetapkan *ppunk ke NULL.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan S_OK. Jika tidak, itu E_FAIL.

Keterangan

Konteks ikat mempertahankan tabel penunjuk antarmuka, masing-masing terkait dengan kunci string. Ini memungkinkan komunikasi antara implementasi moniker dan pemanggil yang memulai operasi pengikatan. Satu pihak dapat menyimpan pointer antarmuka di bawah string yang diketahui oleh kedua belah pihak sehingga pihak lain nantinya dapat mengambilnya dari konteks ikatan.

Penunjuk yang diambil metode ini sebelumnya harus dimasukkan ke dalam tabel menggunakan metode IBindCtx::RegisterObjectParam .

Catatan untuk Penelepon

Objek yang menggunakan moniker untuk menemukan objek lain dapat memanggil metode ini ketika operasi pengikatan gagal mendapatkan informasi spesifik tentang kesalahan yang terjadi. Tergantung pada kesalahan, mungkin untuk memperbaiki situasi dan mencoba kembali operasi pengikatan. Lihat IBindCtx::RegisterObjectParam untuk informasi selengkapnya.

Implementasi Moniker dapat memanggil metode ini untuk menangani situasi di mana penelepon memulai operasi pengikatan dan meminta informasi tertentu. Berdasarkan konvensi, pelaksana harus menggunakan nama kunci yang dimulai dengan bentuk string CLSID dari kelas moniker. (Lihat fungsi StringFromCLSID .)

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	objidl.h

Lihat juga

IBindCtx

Bagikan melalui