Função CoImpersonateClient (combaseapi.h)
Permite que o servidor represente o cliente da chamada atual durante a chamada.
Sintaxe
HRESULT CoImpersonateClient();
Valor retornado
Essa função dá suporte aos valores retornados padrão, incluindo S_OK.
Comentários
Esse método permite que o servidor represente o cliente da chamada atual durante a chamada. Se você não chamar CoRevertToSelf, COM será revertido automaticamente para você. Essa função falhará, a menos que o objeto esteja sendo chamado com RPC_C_AUTHN_LEVEL_CONNECT ou autenticação mais alta em vigor (que é qualquer nível de autenticação, exceto RPC_C_AUTHN_LEVEL_NONE). Essa função encapsula a seguinte sequência de chamadas comuns (tratamento de erro excluído):
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->ImpersonateClient();
pss->Release();
CoImpersonateClient encapsula o processo de obtenção de um ponteiro para uma instância do IServerSecurity que contém dados sobre a chamada atual, chamando seu método ImpersonateClient e liberando o ponteiro. Uma chamada para CoRevertToSelf (ou IServerSecurity::RevertToSelf) desfazerá qualquer número de chamadas para representar o cliente.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | combaseapi.h (inclua Objbase.h) |
| Biblioteca | Ole32.lib |
| DLL | Ole32.dll |
Confira também
IServerSecurity::ImpersonateClient