Función SetTokenInformation (securitybaseapi.h)

Artículo
03/05/2024

La función SetTokenInformation establece varios tipos de información para un token de acceso especificado. La información que establece esta función reemplaza la información existente. El proceso de llamada debe tener los derechos de acceso adecuados para establecer la información.

Sintaxis

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

Parámetros

[in] TokenHandle

Identificador del token de acceso para el que se va a establecer información.

[in] TokenInformationClass

Valor del TOKEN_INFORMATION_CLASS tipo enumerado que identifica el tipo de información que establece la función. Los valores válidos de TOKEN_INFORMATION_CLASS se describen en el parámetro TokenInformation .

[in] TokenInformation

Puntero a un búfer que contiene la información establecida en el token de acceso. La estructura de este búfer depende del tipo de información especificada por el parámetro TokenInformationClass .

[in] TokenInformationLength

Especifica la longitud, en bytes, del búfer al que apunta TokenInformation.

Valor devuelto

Si la función se ejecuta correctamente, la función devuelve un valor distinto de cero.

Si se produce un error en la función, devuelve cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para establecer información de privilegios, una aplicación puede llamar a la función AdjustTokenPrivileges . Para establecer los grupos de un token, una aplicación puede llamar a la función AdjustTokenGroups .

La información del tipo de token solo se puede establecer cuando se crea un token de acceso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	securitybaseapi.h (incluya Windows.h)
Library	Advapi32.lib
Archivo DLL	Advapi32.dll