Função RpcRevertToSelfEx (rpcdce.h)
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 |
|---|---|
|
A chamada foi bem-sucedida. |
|
O servidor não tem um cliente para representar. |
|
O identificador de associação é inválido. |
|
Esse é o tipo errado de associação para esta operação. |
|
Não há suporte para a chamada para esse sistema operacional, esse transporte ou esse subsistema de segurança. |
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 |