Función CoImpersonateClient (combaseapi.h)
Permite al servidor suplantar al cliente de la llamada actual mientras dure la llamada.
Sintaxis
HRESULT CoImpersonateClient();
Valor devuelto
Esta función admite los valores devueltos estándar, incluidos los S_OK.
Comentarios
Este método permite al servidor suplantar al cliente de la llamada actual mientras dure la llamada. Si no llama a CoRevertToSelf, COM se revierte automáticamente. Esta función producirá un error a menos que se llame al objeto con RPC_C_AUTHN_LEVEL_CONNECT o una autenticación superior en vigor (que es cualquier nivel de autenticación excepto RPC_C_AUTHN_LEVEL_NONE). Esta función encapsula la siguiente secuencia de llamadas comunes (se excluye el control de errores):
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->ImpersonateClient();
pss->Release();
CoImpersonateClient encapsula el proceso de obtener un puntero a una instancia de IServerSecurity que contiene datos sobre la llamada actual, llamar a su método ImpersonateClient y, a continuación, liberar el puntero. Una llamada a CoRevertToSelf (o IServerSecurity::RevertToSelf) deshacerá cualquier número de llamadas para suplantar al cliente.
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | combaseapi.h (incluya Objbase.h) |
| Library | Ole32.lib |
| Archivo DLL | Ole32.dll |
Consulte también
IServerSecurity::ImpersonateClient