Compartilhar via


Função SetTokenInformation (securitybaseapi.h)

A função SetTokenInformation define vários tipos de informações para um token de acesso especificado. As informações que essa função define substituem as informações existentes. O processo de chamada deve ter direitos de acesso apropriados para definir as informações.

Sintaxe

BOOL SetTokenInformation(
  [in] HANDLE                  TokenHandle,
  [in] TOKEN_INFORMATION_CLASS TokenInformationClass,
  [in] LPVOID                  TokenInformation,
  [in] DWORD                   TokenInformationLength
);

Parâmetros

[in] TokenHandle

Um identificador para o token de acesso para o qual as informações devem ser definidas.

[in] TokenInformationClass

Um valor do TOKEN_INFORMATION_CLASS tipo enumerado que identifica o tipo de informação que a função define. Os valores válidos de TOKEN_INFORMATION_CLASS são descritos no parâmetro TokenInformation .

[in] TokenInformation

Um ponteiro para um buffer que contém as informações definidas no token de acesso. A estrutura desse buffer depende do tipo de informação especificado pelo parâmetro TokenInformationClass .

[in] TokenInformationLength

Especifica o comprimento, em bytes, do buffer apontado por TokenInformation.

Retornar valor

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

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

Comentários

Para definir informações de privilégio, um aplicativo pode chamar a função AdjustTokenPrivileges . Para definir os grupos de um token, um aplicativo pode chamar a função AdjustTokenGroups .

As informações de tipo de token só podem ser definidas quando um token de acesso é criado.

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

Confira também

Visão geral do Controle de Acesso

AdjustTokenGroups

AdjustTokenPrivileges

Funções de Controle de Acesso básicas

GetTokenInformation

OpenProcessToken

Openthreadtoken

TOKEN_DEFAULT_DACL

TOKEN_INFORMATION_CLASS

TOKEN_OWNER

TOKEN_PRIMARY_GROUP