Função CoImpersonateClient (combaseapi.h)

  • Artigo

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

Camuflagem

IServerSecurity::ImpersonateClient

Representação

Representação e chamadas assíncronas

Segurança no COM