Função RevertToSelf (securitybaseapi.h)

Artigo
08/25/2023

A função RevertToSelf encerra a representação de um aplicativo cliente.

Sintaxe

BOOL RevertToSelf();

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um processo deve chamar a função RevertToSelf depois de concluir qualquer representação iniciada usando a função DdeImpersonateClient, ImpersonateDdeClientWindow, ImpersonateLoggedOnUser, ImpersonateNamedPipeClient, ImpersonateSelf, ImpersonateAnonymousToken ou SetThreadToken .

Um servidor RPC que usou a função RpcImpersonateClient para representar um cliente deve chamar RpcRevertToSelf ou RpcRevertToSelfEx para encerrar a representação.

Se RevertToSelf falhar, seu aplicativo continuará sendo executado no contexto do cliente, o que não é apropriado. Você deverá desligar o processo se RevertToSelf falhar.

Exemplos

Para obter um exemplo que usa essa função, consulte Verificando o acesso do cliente com ACLs.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	securitybaseapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll