CoImpersonateClient
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função permite que o servidor para representar o cliente do atual chamar para a duração do chamar.
Syntax
HRESULT CoImpersonateClient( )
Parameters
Nenhum.
Return Value
Essa função suporta o padrão retornam valores, incluindo o seguinte valor:
- S_OK
Indica sucesso.
Remarks
Esse método permite que o servidor para representar o cliente do atual chamar para a duração do chamar. Se você não fizer isso chamar CoRevertToSelf, COM será revertido automaticamente para você.
Essa função falhará a menos que o objeto está sendo chamado com RPC_C_AUTHN_LEVEL_CONNECT ou autenticação maior aplicado (que é qualquer nível de autenticação, exceto RPC_C_AUTHN_LEVEL_NONE).
Essa função encapsula a seguinte seqüência de comum chama (manipulação de erro excluídos).
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->ImpersonateClient();
pss->Release();
CoImpersonateClient encapsula o processo de obter um ponteiro para uma instância de IServerSecurity que contém dados sobre o atual chamar, chamado seu ImpersonateClient método e, em seguida, liberar o ponteiro.
Chamar um para CoRevertToSelf (ou IServerSecurity::RevertToSelf) irá desfazer qualquer número de ImpersonateClient Chamadas.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |