IWbemUnsecuredApartment::CreateSinkStub method (wbemcli.h)

Artikel
08/27/2023

Metode CreateSinkStub mirip dengan IUnsecuredApartment::CreateObjectStub dan membuat sink penerus objek dan melakukan pemeriksaan akses untuk menerima panggilan asinkron dari Manajemen Windows. CreateSinkStub berbeda dari CreateObjectStub karena dapat menentukan bahwa panggilan balik ke sink harus diautentikasi.

WMI menyediakan proses Unsecapp.exe untuk berfungsi sebagai proses terpisah. Anda dapat menghosting Unsecapp.exe dengan panggilan ke antarmuka IWbemUnsecuredApartment atau antarmuka IUnsecuredApartment di versi Windows lainnya. IUnsecuredApartment tidak memiliki metode apa pun yang melakukan pemeriksaan akses.

Pemeriksaan akses berarti bahwa Unsecapp.exe hanya memungkinkan akun komputer yang awalnya mendapatkan sink untuk memanggil panggilan balik. Ketika kunci registri UnsecAppAccessControlDefault diatur ke nol maka Unsecapp.exe tidak melakukan kontrol akses pada panggilan balik kecuali CreateSinkStub dipanggil oleh aplikasi dengan parameter dwFlag diatur ke WBEM_FLAG_UNSECAPP_CHECK_ACCESS. Jika parameter tidak ada, yang merupakan default, maka Unsecapp.exe membaca nilai kunci registri untuk menentukan apakah akan mengautentikasi panggilan balik.

Sintaks

HRESULT CreateSinkStub(
  [in]  IWbemObjectSink *pSink,
  [in]  DWORD           dwFlags,
        LPCWSTR         wszReserved,
  [out] IWbemObjectSink **ppStub
);

Parameter

[in] pSink

Arahkan ke implementasi IWbemObjectSink dalam proses klien.

[in] dwFlags

Anda bisa mengatur salah satu nilai berikut dari enumerasi WBEM_UNSECAPP_FLAG_TYPE . Parameter ini menentukan bagaimana Unsecapp.exe menggunakan kunci registri memeriksa kunci registri ini:

\ HKEY_LOCAL_MACHINEPERANGKAT LUNAK\Microsoft\WBEM\CIMOM\UnsecAppAccessControlDefault

WBEM_FLAG_UNSECAPP_DEFAULT_CHECK_ACCESS

Unsecapp.exe membaca kunci registri UnsecAppAccessControlDefault untuk menentukan apakah harus mengautentikasi panggilan balik.

WBEM_FLAG_UNSECAPP_CHECK_ACCESS

Unsecapp.exe mengautentikasi panggilan balik terlepas dari pengaturan kunci registri UnsecAppAccessControlDefault.

WBEM_FLAG_UNSECAPP_DONT_CHECK_ACCESS

Unsecapp.exe tidak mengautentikasi panggilan balik terlepas dari pengaturan kunci registri UnsecAppAccessControlDefault.

wszReserved

Dicadangkan.

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

Mengembalikan nilai

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

Metode ini disediakan untuk meningkatkan keamanan panggilan asinkron dari aplikasi klien. Untuk informasi selengkapnya, lihat Mengatur Keamanan pada Panggilan Asinkron.

Persyaratan


Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	Wbemuuid.lib
DLL	Unsecapp.exe