Função ImpersonateSelf (securitybaseapi.h)

Artigo
03/01/2024

A função ImpersonateSelf obtém um token de acesso que representa o contexto de segurança do processo de chamada. O token é atribuído ao thread de chamada.

Sintaxe

BOOL ImpersonateSelf(
  [in] SECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);

Parâmetros

[in] ImpersonationLevel

Especifica um tipo enumerado SECURITY_IMPERSONATION_LEVEL que fornece o nível de representação do novo token.

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

A função ImpersonateSelf é usada para tarefas como habilitar um privilégio para um único thread em vez de para todo o processo ou para alterar a DACL ( lista de controle de acesso discricionário ) padrão para um único thread.

O servidor pode chamar a função RevertToSelf quando a representação for concluída.

Para que essa função tenha êxito, a DACL que protege o token de processo deve conceder ao TOKEN_DUPLICATE direito a si mesmo.

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