Função RpcRevertToSelfEx (rpcdce.h)

  • Artigo

A função RpcRevertToSelfEx permite que um servidor represente um cliente e, em seguida, reverter em uma operação multithread em que a chamada para representar um cliente pode vir de um thread diferente do thread originalmente despachado do RPC.

Sintaxe

RPC_STATUS RpcRevertToSelfEx(
  RPC_BINDING_HANDLE BindingHandle
);

Parâmetros

BindingHandle

Identificador de associação no servidor que representa uma associação ao cliente que o servidor representou. Um valor igual a zero especifica o identificador do cliente do thread atual; nesse caso, a funcionalidade de RpcRevertToSelfEx é idêntica à da função RpcRevertToSelf .

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_NO_CALL_ACTIVE
 O servidor não tem um cliente para representar.
RPC_S_INVALID_BINDING
 O identificador de associação é inválido.
RPC_S_WRONG_KIND_OF_BINDING
 Esse é o tipo errado de associação para esta operação.
RPC_S_CANNOT_SUPPORT
 Não há suporte para a chamada para esse sistema operacional, esse transporte ou esse subsistema de segurança.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Depois de chamar RpcImpersonateClient e concluir todas as tarefas que exigem representação do cliente, o servidor chama RpcRevertToSelfEx para encerrar a representação e restabelecer sua própria identidade de segurança. Por exemplo, considere um thread primário, chamado thread1, que é despachado de um cliente remoto e ativa um thread de trabalho, chamado thread2. Se o thread2 exigir que o servidor represente o cliente, o servidor chamará RpcImpersonateClient(THREAD1_CALL_HANDLE), executará a tarefa necessária, chamará RpcRevertToSelfEx(THREAD1_CALL_HANDLE) para encerrar a representação e, em seguida, ativará o thread1.

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 rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

Client Impersonation (em inglês)

RpcImpersonateClient

RpcRevertToSelf