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
IServerSecurity::ImpersonateClient