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

  • Статья

Функция IsTokenRestricted указывает, содержит ли маркер список идентификаторов безопасности с ограниченным доступом( SID).

Синтаксис

BOOL IsTokenRestricted(
  [in] HANDLE TokenHandle
);

Параметры

[in] TokenHandle

Дескриптор маркера доступа для проверки.

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

Если маркер содержит список ограничивающих идентификаторов безопасности, возвращаемое значение не равно нулю.

Если маркер не содержит список ограничивающих идентификаторов безопасности, возвращаемое значение равно нулю.

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

Комментарии

Функция CreateRestrictedToken может ограничить маркер, отключив идентификаторы безопасности, удалив привилегии и указав список ограничивающих идентификаторов безопасности. Функция IsTokenRestricted проверяет только список ограничивающих идентификаторов безопасности. Если маркер не имеет ограничивающих идентификаторов безопасности, IsTokenRestricted возвращает значение FALSE, даже если маркер был создан путем вызова Метода CreateRestrictedToken.

Требования

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

См. также раздел

Обзор контроль доступа

Базовые функции контроль доступа

CreateRestrictedToken