Função SetTokenInformation (securitybaseapi.h)

Artigo
03/01/2024

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