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

Cloaking

IServerSecurity::ImpersonateClient

Penyamaran

Peniruan Dan Panggilan Asinkron

Keamanan di COM