Функция 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 |