Funzione CoImpersonateClient (combaseapi.h)

Consente al server di rappresentare il client della chiamata corrente per la durata della chiamata.

Sintassi

HRESULT CoImpersonateClient();

Valore restituito

Questa funzione supporta i valori restituiti standard, inclusi i S_OK.

Commenti

Questo metodo consente al server di rappresentare il client della chiamata corrente per la durata della chiamata. Se non si chiama CoRevertToSelf, COM viene ripristinato automaticamente. Questa funzione avrà esito negativo a meno che l'oggetto non venga chiamato con RPC_C_AUTHN_LEVEL_CONNECT o più autenticazione in effetti (ovvero qualsiasi livello di autenticazione tranne RPC_C_AUTHN_LEVEL_NONE). Questa funzione incapsula la sequenza seguente di chiamate comuni (gestione degli errori esclusa):

    CoGetCallContext(IID_IServerSecurity, (void**)&pss);
    pss->ImpersonateClient();
    pss->Release();

CoImpersonateClient incapsula il processo di recupero di un puntatore a un'istanza di IServerSecurity che contiene dati sulla chiamata corrente, chiamando il metodo ImpersonateClient e quindi rilasciando il puntatore. Una chiamata a CoRevertToSelf (o IServerSecurity::RevertToSelf) annulla qualsiasi numero di chiamate per rappresentare il client.

Requisiti

Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

Cloaking

IServerSecurity::ImpersonateClient

Rappresentazione

Rappresentazione e chiamate asincrone

Sicurezza in COM