Metode IUnsecuredApartment::CreateObjectStub (wbemcli.h)

Artikel
03/03/2024

Metode CreateObjectStub membuat sink penerus objek untuk membantu menerima panggilan asinkron dari Manajemen Windows. Fungsi ini mengikat sink objek yang tidak aman ke sink objek lokal sehingga keamanan COM tidak mengganggu pengambilan asinkron objek CIM. Karena keamanan COM sedang dilewati, server Manajemen Windows jarak jauh diasumsikan sebagai komponen tepercaya.

Paradigma umum adalah bahwa implementasi asli IWbemObjectSink dalam proses klien tidak langsung digunakan dalam panggilan asinkron ke IWbemServices. Sebaliknya, implementasi asli dan objek pengganti dibuat, diikat bersama-sama, dan kemudian objek pengganti digunakan dalam metode asinkron IWbemServices.

Sintaks

HRESULT CreateObjectStub(
  [in]  IUnknown *pObject,
  [out] IUnknown **ppStub
);

Parameter

[in] pObject

Arahkan ke implementasi IWbemObjectSink dalam proses klien.

[out] ppStub

Menerima pointer ke objek pengganti yang akan digunakan dalam panggilan IWbemServices asinkron. Pengguna menerima pointer IUnknown dan harus memanggil QueryInterface untuk IID_WbemObjectSink sebelum menggunakan objek ini dalam panggilan IWbemServices asinkron.

Nilai kembali

Metode ini mengembalikan kode kesalahan COM standar untuk QueryInterface. Ini mengembalikan S_OK jika panggilan berhasil. Jika panggilan gagal karena antarmuka yang diminta tidak didukung, metode akan mengembalikan E_NOINTERFACE.

Kode kesalahan khusus COM juga dapat dikembalikan jika masalah jaringan menyebabkan Anda kehilangan koneksi jarak jauh ke Manajemen Windows.

Keterangan

Catatan Karena panggilan balik ke sink mungkin tidak dikembalikan pada tingkat autentikasi yang sama dengan yang dibutuhkan klien, disarankan agar Anda menggunakan semisinkron alih-alih komunikasi asinkron. Untuk informasi selengkapnya, lihat Memanggil Metode.

Contoh

Untuk contoh lengkap yang menunjukkan cara menggunakan antarmuka IUnsecuredApartment , lihat Contoh: Menerima Pemberitahuan Peristiwa Melalui WMI.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Unsecapp.exe