Metode IGlobalInterfaceTable::GetInterfaceFromGlobal (objidl.h)

Artikel
02/29/2024

Mengambil pointer ke antarmuka pada objek yang dapat digunakan oleh apartemen panggilan. Antarmuka ini saat ini harus terdaftar dalam tabel antarmuka global.

Sintaks

HRESULT GetInterfaceFromGlobal(
  [in]  DWORD  dwCookie,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameter

[in] dwCookie

Mengidentifikasi antarmuka (dan objeknya), dan diambil melalui panggilan ke IGlobalInterfaceTable::RegisterInterfaceInGlobal.

[in] riid

IID antarmuka.

[out] ppv

Penunjuk ke penunjuk untuk antarmuka yang diminta.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil diselesaikan.
E_INVALIDARG	Satu atau beberapa parameter tidak valid.

Keterangan

Setelah antarmuka terdaftar di tabel antarmuka global, apartemen bisa mendapatkan pointer ke antarmuka ini dengan memanggil metode GetInterfaceFromGlobal dengan cookie yang disediakan. Pointer ke antarmuka ini dapat digunakan di apartemen panggilan tetapi tidak oleh apartemen lain dalam prosesnya.

Aplikasi ini bertanggung jawab untuk mengoordinasikan akses ke variabel global selama panggilan ke IGlobalInterfaceTable::RevokeInterfaceFromGlobal. Artinya, aplikasi harus memastikan bahwa satu utas tidak memanggil RevokeInterfaceFromGlobal sementara utas lain memanggil GetInterfaceFromGlobal dengan cookie yang sama. Beberapa panggilan ke GetInterfaceFromGlobal untuk cookie yang sama diizinkan.

Metode GetInterfaceFromGlobal memanggil AddRef pada pointer yang diperoleh dalam parameter ppv . Pemanggil bertanggung jawab untuk memanggil Rilis pada pointer ini.

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 (termasuk ObjIdl.h)

Lihat juga

IGlobalInterfaceTable

Bagikan melalui