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

Метод ChangeSecurityPermissionsEx класса CIM_Directory

  • Статья

Метод ChangeSecurityPermissionsEx изменяет разрешения безопасности для файла записи логического каталога, указанного в пути к объекту (этот метод является расширенной версией метода ChangeSecurityPermissions и наследуется от CIM_LogicalFile). Если логический файл является каталогом, этот метод будет действовать рекурсивно, изменяя разрешения безопасности для всех файлов и вложенных каталогов, содержащихся в каталоге.

Важно!

Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых строятся классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.

В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .

Синтаксис

uint32 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

Параметры

SecurityDescriptor [in]

Указывает сведения о безопасности.

Примечание

ACL NULL в структуре SECURITY_DESCRIPTOR предоставляет неограниченный доступ.

Параметр [in]

Права безопасности для изменения. Например, чтобы изменить владельца и безопасность DACL, используйте

Option = 1 + 4

или

Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION

CHANGE_OWNER_SECURITY_INFORMATION (1)

Изменение владельца логического файла.

CHANGE_GROUP_SECURITY_INFORMATION (2)

Измените группу логического файла.

CHANGE_DACL_SECURITY_INFORMATION (4)

Измените список ACL логического файла.

CHANGE_SACL_SECURITY_INFORMATION (8)

Измените системный список управления доступом для логического файла.

StopFileName [out]

Строка, представляющая имя файла (или каталога), в котором произошел сбой метода. При успешном выполнении метода этот параметр имеет значение NULL .

StartFileName [in, необязательный]

Строка, представляющая дочерний файл (или каталог), используемый в качестве отправной точки для этого метода. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл (или каталог), в котором произошла ошибка при предыдущем вызове метода. Если значение параметра равно NULL, операция выполняется в файле или каталоге, указанном в вызове ExecMethod .

Рекурсивный [in, необязательный]

Если задано значение TRUE, метод также рекурсивно применяется к файлам и каталогам в каталоге, указанном экземпляром CIM_Directory . Для экземпляров файлов этот параметр игнорируется.

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

Возвращает значение 0 (ноль) при успешном выполнении и любое другое число, указывающее на ошибку.

0

Успешно.

2

Доступ запрещен.

8

Неуказанным сбоем.

9

Недопустимый объект.

10

Объект уже существует.

11

Файловая система не NTFS.

12

Платформа, а не Windows.

13

Диск не тот же.

14

Каталог не пуст.

15

Нарушение правил общего доступа.

16

Недопустимый начальный файл.

17

Привилегия не удерживаема.

21

Недопустимый параметр.

Комментарии

В настоящее время этот метод не реализуется WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.

Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Пространство имен
 Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

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

CIM_Directory

CIM_Directory