Função DuplicateToken (securitybaseapi.h)

Artigo
08/25/2023

A função DuplicateToken cria um novo token de acesso que duplica um já existente.

Sintaxe

BOOL DuplicateToken(
  [in]  HANDLE                       ExistingTokenHandle,
  [in]  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel,
  [out] PHANDLE                      DuplicateTokenHandle
);

Parâmetros

[in] ExistingTokenHandle

Um identificador para um token de acesso aberto com acesso TOKEN_DUPLICATE.

[in] ImpersonationLevel

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

[out] DuplicateTokenHandle

Um ponteiro para uma variável que recebe um identificador para o token duplicado. Esse identificador tem acesso TOKEN_IMPERSONATE e TOKEN_QUERY ao novo token.

Quando terminar de usar o novo token, chame a função CloseHandle para fechar o identificador de 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 DuplicateToken cria um token de representação, que você pode usar em funções como SetThreadToken e ImpersonateLoggedOnUser. O token criado por DuplicateToken não pode ser usado na função CreateProcessAsUser , que requer um token primário. Para criar um token que você pode passar para CreateProcessAsUser, use a função DuplicateTokenEx .

Requisitos

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