Метод SetConfigurationSecurityDescriptor класса Win32_DCOMApplicationSetting

Метод SetConfigurationSecurityDescriptor обновляет дескриптор безопасности конфигурации приложения DCOM новым дескриптором безопасности, определяемым экземпляром класса Win32_SecurityDescriptor . Этот дескриптор безопасности определяет, кому разрешено настраивать приложение. Учетная запись, в которой выполняется скрипт или приложение, которое вызывает этот метод, должна иметь привилегии SeSecurityPrivilege и SeRestorePrivilege . Дополнительные сведения см. в разделе Изменение безопасности доступа в защищаемых объектах.

Синтаксис

uint32 SetConfigurationSecurityDescriptor(
  [in] Win32_SecurityDescriptor Descriptor
);

Параметры

Дескриптор [вход]

Дескриптор безопасности, который необходимо задать для приложения DCOM.

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

Возвращает одно из значений, перечисленных в следующем списке, или другое значение, указывающее на ошибку. Дополнительные сведения см. в разделе Коды возврата WMI или WbemErrorEnum.

Успешно

0

Успешное завершение

2

Пользователь не имеет доступа к запрошенным сведениям

8

Неизвестный сбой

9

Пользователь не имеет достаточных привилегий для выполнения метода

21

Недопустимый параметр, указанный в вызове метода

Другое

1 4294967295

Комментарии

Экземпляр Win32_SecurityDescriptor представляет SECURITY_DESCRIPTOR_CONTROL тип данных и содержит список управления доступом на уровне пользователей (DACL) и список управления доступом системы (SACL). Дополнительные сведения см. в разделе Списки контроль доступа.

Если параметр SeSecurityPrivilege не предоставляется или не включен при получении дескриптора безопасности, то в возвращаемом дескрипторе безопасности возвращается только DACL. Дополнительные сведения см. в разделах Константы привилегий и Выполнение привилегированных операций.

При вызове этого метода можно обновить как DACL, так и SACL в экземпляре Win32_SecurityDescriptor , но также можно обновить только DACL или только SACL.

Следующие значения в SECURITY_DESCRIPTOR_CONTROL определяют, обновляются ли DACL, SACL или и то, и другое.

• SE_DACL_PRESENT

  Указывает, что dacl необходимо обновить. Если этот параметр не задан, WMI сохраняет исходное значение DACL.

• SE_SACL_PRESENT

  Указывает, что saCL должен быть обновлен. Если этот параметр не задан, инструментарий WMI сохраняет исходное значение saCL. Чтобы обновить SACL, у учетной записи должна быть включена привилегия SeSecurityPrivilege . Для создания скриптов имя привилегии — SeSecurityPrivilege. Дополнительные сведения см. в разделе Константы привилегий.

Если свойства доверенного лица группы и доверенного лица владельца не имеют значения NULL, они обновляются. В противном случае WMI сохраняет исходные значения. Дополнительные сведения см. в разделе Объекты дескриптора безопасности WMI.

Если новый saCL имеет значение NULL в вызове этого метода, то дескриптор безопасности SACL для целевого защищаемого объекта остается без изменений.

Требования

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

Win32_DCOMApplicationSetting

Константы привилегий

Объекты дескриптора безопасности WMI

Изменение безопасности доступа к защищаемым объектам