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

Статья
08/25/2023

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

Синтаксис

BOOL CheckTokenMembershipEx(
  [in, optional] HANDLE TokenHandle,
  [in]           PSID   SidToCheck,
  [in]           DWORD  Flags,
  [out]          PBOOL  IsMember
);

Параметры

[in, optional] TokenHandle

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

[in] SidToCheck

Указатель на структуру sid. Функция проверяет наличие этого идентификатора безопасности при наличии маркера.

[in] Flags

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

[out] IsMember

ЗНАЧЕНИЕ TRUE , если идентификатор безопасности включен в маркере; в противном случае — FALSE.

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

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

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

Требования


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