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

Статья
08/25/2023

Функция CheckTokenCapability проверяет возможности заданного маркера.

Синтаксис

BOOL CheckTokenCapability(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   CapabilitySidToCheck,
  [out]          PBOOL  HasCapability
);

Параметры

[in, optional] TokenHandle

Дескриптор маркера доступа. Дескриптор должен иметь TOKEN_QUERY доступ к маркеру. Маркер должен быть маркером олицетворения.

Если TokenHandle имеет значение NULL, CheckTokenCapability использует токен олицетворения вызывающего потока. Если поток не олицетворение, функция дублирует основной маркер потока для создания токена олицетворения.

[in] CapabilitySidToCheck

Указатель на структуру ИД безопасности возможностей. Функция CheckTokenCapability проверяет возможности этого маркера доступа.

[out] HasCapability

Получает результаты проверка. Если у маркера доступа есть возможность, он возвращает true, в противном случае — false.

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

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

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

Требования


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