Метод ChangeSecurityPermissionsEx класса Win32_CodecFile
Метод класса 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_CodecFile.
-
Option [in]
-
Фактические права безопасности, которые необходимо изменить. Например, чтобы изменить безопасность владельца и списка управления доступом на уровне пользователей (DACL), используйте следующую команду:
Option = 1 + 4-или-
Option = CHANGE_OWNER_SECURITY_INFORMATION | CHANGE_DACL_SECURITY_INFORMATION -
CHANGE_OWNER_SECURITY_INFORMATION (1 (0x1))
-
Изменение владельца логического файла.
-
CHANGE_GROUP_SECURITY_INFORMATION (2 (0x2))
-
Измените группу логического файла.
-
CHANGE_DACL_SECURITY_INFORMATION (4 (0x4))
-
Измените список управления доступом на уровне пользователей (DACL) логического файла.
-
CHANGE_SACL_SECURITY_INFORMATION (8 (0x8))
-
Измените системный список управления доступом (SACL) логического файла.
StopFileName [out]
Имя файла или каталога, в котором произошел сбой метода ChangeSecurityPermissionsEx . Этот параметр имеет значение NULL при успешном выполнении метода.
StartFileName [in, необязательный]
Присваивает имя дочернему файлу или каталогу для использования в качестве отправной точки для ChangeSecurityPermissionsEx. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл или каталог, в котором произошла ошибка из предыдущего вызова метода. Если этот параметр имеет значение NULL, операция выполняется в файле или каталоге, указанном в вызове ExecMethod .
Рекурсивный [in, необязательный]
Если значение равно true, изменения прав владения рекурсивно применяются к файлам и каталогам в каталоге, который указан экземпляром CIM_LogicalFile . Для экземпляров файлов параметр рекурсивных входных данных игнорируется.
Возвращаемое значение
Возвращает значение 0 (ноль), если разрешения изменены, и другое число, указывающее на ошибку.
-
Успешно
-
0
Запрос выполнен успешно.
-
доступ запрещен
-
2
Отказано в доступе".
-
Неопределенный сбой
-
8
Произошел неопределенный сбой.
-
Недопустимый объект
-
9
Указанное имя недопустимо.
-
Объект уже существует
-
10
Указанный объект уже существует.
-
Файловая система не NTFS
-
11
Файловая система не является файловой системой NTFS.
-
Платформа, не NT/Windows 2000
-
12
Платформа не Windows NT или Windows 2000.
-
Диск не тот же
-
13
Диск отличается.
-
Каталог не пуст
-
14
Каталог не пуст.
-
Нарушение общего доступа
-
15
Имеется нарушение общего доступа.
-
Недопустимый начальный файл
-
16
Указанный начальный файл недопустим.
-
Привилегия не удерживаема
-
17
Привилегия, необходимая для операции, не удерживается.
-
недопустимый параметр.
-
21
Указанный параметр является недопустимым.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|