Función GetTokenInformation (securitybaseapi.h)

Artículo
08/25/2023

La función GetTokenInformation recupera un tipo de información especificado sobre un token de acceso. El proceso de llamada debe tener los derechos de acceso adecuados para obtener la información.

Para determinar si un usuario es miembro de un grupo específico, use la función CheckTokenMembership . Para determinar la pertenencia a grupos para los tokens de contenedor de aplicaciones, use la función CheckTokenMembershipEx .

Sintaxis

BOOL GetTokenInformation(
  [in]            HANDLE                  TokenHandle,
  [in]            TOKEN_INFORMATION_CLASS TokenInformationClass,
  [out, optional] LPVOID                  TokenInformation,
  [in]            DWORD                   TokenInformationLength,
  [out]           PDWORD                  ReturnLength
);

Parámetros

[in] TokenHandle

Identificador de un token de acceso desde el que se recupera la información. Si TokenInformationClass especifica TokenSource , el identificador debe tener TOKEN_QUERY_SOURCE acceso. Para todos los demás valores de TokenInformationClass , el identificador debe tener TOKEN_QUERY acceso.

[in] TokenInformationClass

Especifica un valor del tipo enumerado TOKEN_INFORMATION_CLASS para identificar el tipo de información que recupera la función. Cualquier llamador que compruebe TokenIsAppContainer y que devuelva 0 también debe comprobar que el token del autor de la llamada no es un token de suplantación de nivel de identificación. Si el token actual no es un contenedor de aplicaciones, pero es un token de nivel de identidad, debe devolver AccessDenied.

[out, optional] TokenInformation

Puntero a un búfer que la función rellena con la información solicitada. La estructura que se coloca en este búfer depende del tipo de información especificada por el parámetro TokenInformationClass .

[in] TokenInformationLength

Especifica el tamaño, en bytes, del búfer al que apunta el parámetro TokenInformation . Si TokenInformation es NULL, este parámetro debe ser cero.

[out] ReturnLength

Puntero a una variable que recibe el número de bytes necesarios para el búfer al que apunta el parámetro TokenInformation . Si este valor es mayor que el valor especificado en el parámetro TokenInformationLength , se produce un error en la función y no almacena datos en el búfer.

Si el valor del parámetro TokenInformationClass es TokenDefaultDacl y el token no tiene ninguna DACL predeterminada, la función establece la variable a la que apunta ReturnLength en sizeof(TOKEN_DEFAULT_DACL) y establece el miembro DefaultDacl de la estructura de TOKEN_DEFAULT_DACL en NULL.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos


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