Функция GetTokenInformation (securitybaseapi.h)

Статья
08/25/2023

Функция GetTokenInformation извлекает указанный тип сведений о маркере доступа. Вызывающий процесс должен иметь соответствующие права доступа для получения информации.

Чтобы определить, является ли пользователь членом определенной группы, используйте функцию CheckTokenMembership . Чтобы определить членство в группе для маркеров контейнера приложений, используйте функцию CheckTokenMembershipEx .

Синтаксис

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

Параметры

[in] TokenHandle

Дескриптор маркера доступа, из которого извлекаются сведения. Если TokenInformationClass указывает TokenSource, дескриптор должен иметь TOKEN_QUERY_SOURCE доступ. Для всех остальных значений TokenInformationClass дескриптор должен иметь TOKEN_QUERY доступ.

[in] TokenInformationClass

Задает значение из перечисленного типа TOKEN_INFORMATION_CLASS для определения типа сведений, извлекаемых функцией. Все вызывающие лица, которые проверка TokenIsAppContainer и возвращают 0, также должны убедиться, что маркер вызывающего объекта не является маркером олицетворения уровня идентификации. Если текущий маркер не является контейнером приложения, а маркером уровня удостоверения, необходимо вернуть AccessDenied.

[out, optional] TokenInformation

Указатель на буфер, заполняемый функцией запрошенными сведениями. Структура, помещаемая в этот буфер, зависит от типа информации, указанной параметром TokenInformationClass .

[in] TokenInformationLength

Указывает размер (в байтах) буфера, на который указывает параметр TokenInformation . Если параметр TokenInformation имеет значение NULL, этот параметр должен быть равен нулю.

[out] ReturnLength

Указатель на переменную, получающую количество байтов, необходимых для буфера, на который указывает параметр TokenInformation . Если это значение больше значения, указанного в параметре TokenInformationLength , функция завершается ошибкой и данные не сохраняются в буфере.

Если параметр TokenInformationClass имеет значение TokenDefaultDacl и у маркера нет daCL по умолчанию, функция задает переменной, на которую указывает ReturnLengthsizeof(, значение TOKEN_DEFAULT_DACL) и значение NULL для элемента DefaultDacl структуры TOKEN_DEFAULT_DACL.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	securitybaseapi.h (включая Windows.h)
Библиотека	Advapi32.lib
DLL	Advapi32.dll