Função OpenThreadToken (processthreadsapi.h)

Artigo
08/25/2023

A função OpenThreadToken abre o token de acesso associado a um thread.

Sintaxe

BOOL OpenThreadToken(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   DesiredAccess,
  [in]  BOOL    OpenAsSelf,
  [out] PHANDLE TokenHandle
);

Parâmetros

[in] ThreadHandle

Um identificador para o thread cujo token de acesso é aberto.

[in] DesiredAccess

Especifica uma máscara de acesso que especifica os tipos solicitados de acesso ao token de acesso. Esses tipos de acesso solicitados são reconciliados com a DACL ( lista de controle de acesso discricionário ) do token para determinar quais acessos são concedidos ou negados.

Para obter uma lista de direitos de acesso para tokens de acesso, consulte Direitos de Acesso para objetos Access-Token.

[in] OpenAsSelf

TRUE se a marcar de acesso for feita no contexto de segurança em nível de processo.

FALSE se o marcar de acesso for feito no contexto de segurança atual do thread que chama a função OpenThreadToken.

O parâmetro OpenAsSelf permite que o chamador dessa função abra o token de acesso de um thread especificado quando o chamador estiver representando um token no nível de SecurityIdentification . Sem esse parâmetro, o thread de chamada não pode abrir o token de acesso no thread especificado porque é impossível abrir objetos de nível executivo usando o nível de representação SecurityIdentification .

[out] TokenHandle

Um ponteiro para uma variável que recebe o identificador para o token de acesso recém-aberto.

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. Se o token tiver o nível de representação anônimo, o token não será aberto e OpenThreadToken definirá ERROR_CANT_OPEN_ANONYMOUS como o erro.

Comentários

Tokens com o nível de representação anônimo não podem ser abertos.

Feche o identificador de token de acesso retornado por meio do parâmetro TokenHandle chamando CloseHandle.

Requisitos


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	processthreadsapi.h (inclua Windows.h)
Biblioteca	Advapi32.lib
DLL	Advapi32.dll