Функция SetSecurityDescriptorControl (securitybaseapi.h)
Функция SetSecurityDescriptorControl задает биты элементов управления дескриптора безопасности. Функция может задавать только биты элементов управления, связанные с автоматическим наследованием ACE. Чтобы задать другие биты элемента управления дескриптора безопасности, используйте функции, например SetSecurityDescriptorDacl, для изменения компонентов дескриптора безопасности.
Синтаксис
BOOL SetSecurityDescriptorControl(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
[in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);
Параметры
[in] pSecurityDescriptor
Указатель на SECURITY_DESCRIPTOR структуру, для которой заданы сведения об управлении и редакции.
[in] ControlBitsOfInterest
Маска SECURITY_DESCRIPTOR_CONTROL , указывающая устанавливаемые биты элемента управления.
[in] ControlBitsToSet
Маска SECURITY_DESCRIPTOR_CONTROL , указывающая новые значения для битов элементов управления, заданных маской ControlBitsOfInterest .
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Функция SetSecurityDescriptorControl указывает бит или биты элемента управления, которые необходимо изменить, а также указывает, включены ли или отключены биты.
Примеры
В следующем примере daCL в дескрипторе безопасности помечается как защищенный.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, SE_DACL_PROTECTED );
В следующем примере daCL помечается как незащищенный.
SetSecurityDescriptorControl( &SecDesc,
SE_DACL_PROTECTED, 0 );
Требования
| Минимальная версия клиента | Windows XP [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2003 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | securitybaseapi.h (включая Windows.h) |
| Библиотека | Advapi32.lib |
| DLL | Advapi32.dll |