Метод ChangeSecurityPermissionsEx класса Win32_Directory
Метод класса WMI ChangeSecurityPermissionsEx изменяет разрешения безопасности для файла записи каталога, указанного в пути к объекту (этот метод является расширенной версией метода ChangeSecurityPermissions). Если логический файл является каталогом, то этот метод является рекурсивным и изменяет разрешения безопасности для всех файлов и подкаталогов, содержащихся в каталоге.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 ChangeSecurityPermissionsEx(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Параметры
-
SecurityDescriptor [in]
-
Выражение, разрешающееся в экземпляр Win32_SecurityDescriptor. Этот параметр содержит новые разрешения безопасности для экземпляра Win32_PageFile.
-
Параметр [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)
-
Измените список DACL логического файла.
-
CHANGE_SACL_SECURITY_INFORMATION (8)
-
Измените системный список управления доступом (SACL) логического файла.
StopFileName [out]
Имя файла или каталога, в котором произошел сбой метода ChangeSecurityPermissionsEx . Этот параметр имеет значение NULL, если метод выполнен успешно.
StartFileName [in, необязательный]
Именует дочерний файл или каталог для использования в качестве отправной точки для ChangeSecurityPermissionsEx. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл или каталог, в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется с файлом или каталогом, указанным в вызове ExecMethod . Этот параметр является необязательным.
Если используется Параметр StartFileName , для параметра Recursive также должно быть задано значение true.
Рекурсивный [in, необязательный]
Если значение равно true, изменение владельца применяется рекурсивно к файлам и каталогам в каталоге, указанном экземпляром CIM_LogicalFile . Для экземпляров файлов параметр рекурсивных входных данных игнорируется. Этот параметр является необязательным.
Возвращаемое значение
Возвращает значение 0 (ноль), если разрешения изменены, и другое число, указывающее на ошибку.
-
Успешно
-
0
Запрос выполнен успешно.
-
доступ запрещен
-
2
Отказано в доступе".
-
Неуказанным сбоем
-
8
Произошла неуказаная ошибка.
-
Недопустимый объект
-
9
Указанное имя недопустимо.
-
Объект уже существует
-
10
Указанный объект уже существует.
-
Файловая система не NTFS
-
11
Файловая система не является файловой системой NTFS.
-
Платформа не NT/Windows 2000
-
12
Платформа не является Windows.
-
Диск не тот же
-
13
Диск отличается.
-
Каталог не пуст
-
14
Каталог не пуст.
-
Нарушение общего доступа
-
15
Существует нарушение общего доступа.
-
Недопустимый начальный файл
-
16
Указанный начальный файл недопустим.
-
Привилегия не удерживаема
-
17
Привилегия, необходимая для операции, не удерживается.
-
недопустимый параметр.
-
21
Указанный параметр недопустим.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|