Compartilhar via


Função SetThreadToken (processthreadsapi.h)

A função SetThreadToken atribui um token de representação a um thread. A função também pode fazer com que um thread pare de usar um token de representação.

Sintaxe

BOOL SetThreadToken(
  [in, optional] PHANDLE Thread,
  [in, optional] HANDLE  Token
);

Parâmetros

[in, optional] Thread

Um ponteiro para um identificador para o thread ao qual a função atribui o token de representação.

Se Thread for NULL, a função atribuirá o token de representação ao thread de chamada.

[in, optional] Token

Um identificador para o token de representação a ser atribuído ao thread. Esse identificador deve ter sido aberto com direitos de acesso TOKEN_IMPERSONATE. Para obter mais informações, consulte Direitos de Acesso para objetos Access-Token.

Se Token for NULL, a função fará com que o thread pare de usar um token de representação.

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

Ao usar a função SetThreadToken para representar, você deve ter os privilégios de representação e verificar se a função SetThreadToken é bem-sucedida antes de chamar a função RevertToSelf .

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

Confira também

Visão geral do Controle de Acesso

Funções de Controle de Acesso básicas

Openthreadtoken