Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Функция 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 |