Поделиться через


Функция AuthzModifySids (authz.h)

Функция AuthzModifySids добавляет, удаляет или изменяет группы пользователей и устройств в контексте клиента Authz.

Синтаксис

AUTHZAPI BOOL AuthzModifySids(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE     hAuthzClientContext,
  [in]           AUTHZ_CONTEXT_INFORMATION_CLASS SidClass,
  [in]           PAUTHZ_SID_OPERATION            pSidOperations,
  [in, optional] PTOKEN_GROUPS                   pSids
);

Параметры

[in] hAuthzClientContext

Дескриптор для изменяемого контекста клиента.

[in] SidClass

Тип информации, которую необходимо изменить. Вызывающий объект может указать AuthzContextInfoGroupsSids, AuthzContextInfoRestrictedSids или AuthzContextInfoDeviceSids.

[in] pSidOperations

Указатель на массив AUTHZ_SID_OPERATION значений перечисления, определяющих изменения группы.

[in, optional] pSids

Указатель на структуру TOKEN_GROUPS , указывающую группы для изменения.

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

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

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

Комментарии

Перечисление AUTHZ_SID_OPERATION должно иметь только один элемент, если значение этого элемента равно AUTHZ_SID_OPERATION_REPLACE_ALL. В противном случае массив имеет то же количество элементов, что и соответствующий PTOKEN_GROUPS.

Если вы хотите использовать AuthzModifySids для удаления, идентификаторы безопасности сопоставляются, но не флаги SID. Если соответствующий идентификатор безопасности не найден, изменения не выполняются и вызов завершается ошибкой.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header authz.h
Библиотека Authz.lib
DLL Authz.dll