Метод ChangeSecurityPermissionsEx класса Win32_PageFile
Метод класса ChangeSecurityPermissionsExWMI изменяет разрешения безопасности для логического файла подкачки, указанного в пути к объекту (этот метод является расширенной версией метода 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.
-
Option [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 — это параметр StartFileName , указывающий файл или каталог, в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется в файле или каталоге, указанном в вызове ExecMethod .
Рекурсивный [in, необязательный]
Если значение равно true, изменение владельца применяется рекурсивно к файлам и каталогам в каталоге, указанном экземпляром CIM_LogicalFile .
Примечание
Для экземпляров файлов параметр Recursive игнорируется.
Возвращаемое значение
Возвращает значение 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 |
|