Fungsi CoImpersonateClient (combaseapi.h)
Memungkinkan server untuk meniru klien panggilan saat ini selama durasi panggilan.
Sintaks
HRESULT CoImpersonateClient();
Mengembalikan nilai
Fungsi ini mendukung nilai pengembalian standar, termasuk S_OK.
Keterangan
Metode ini memungkinkan server untuk meniru klien panggilan saat ini selama durasi panggilan. Jika Anda tidak memanggil CoRevertToSelf, COM akan kembali secara otomatis untuk Anda. Fungsi ini akan gagal kecuali objek dipanggil dengan RPC_C_AUTHN_LEVEL_CONNECT atau autentikasi yang lebih tinggi yang berlaku (yang merupakan tingkat autentikasi apa pun kecuali RPC_C_AUTHN_LEVEL_NONE). Fungsi ini merangkum urutan panggilan umum berikut (penanganan kesalahan dikecualikan):
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->ImpersonateClient();
pss->Release();
CoImpersonateClient merangkum proses mendapatkan penunjuk ke instans IServerSecurity yang berisi data tentang panggilan saat ini, memanggil metode ImpersonateClient , lalu merilis pointer. Satu panggilan ke CoRevertToSelf (atau IServerSecurity::RevertToSelf) akan membatalkan sejumlah panggilan untuk meniru klien.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | combaseapi.h (termasuk Objbase.h) |
| Pustaka | Ole32.lib |
| DLL | Ole32.dll |
Lihat juga
IServerSecurity::ImpersonateClient