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

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

См. также раздел

Обзор контроль доступа

Базовые функции контроль доступа

GetSecurityDescriptorControl

SECURITY_DESCRIPTOR

SECURITY_DESCRIPTOR_CONTROL

SetSecurityDescriptorDacl