Метод ChangeSecurityPermissions класса CIM_DataFile
Метод ChangeSecurityPermissions изменяет разрешения безопасности для логического файла данных, указанного в пути к объекту. Если логический файл является каталогом, этот метод будет действовать рекурсивно, изменяя разрешения безопасности для всех файлов и вложенных каталогов, содержащихся в каталоге. Этот метод наследуется от CIM_LogicalFile.
Важно!
Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых строятся классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.
В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе Вызов метода .
Синтаксис
uint32 ChangeSecurityPermissions(
[in] Win32_SecurityDescriptor SecurityDescriptor,
[in] uint32 Option
);
Параметры
-
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)
-
Измените системный список управления доступом для логического файла.
Возвращаемое значение
Возвращает значение 0 при успешном выполнении и любое другое число, указывающее на ошибку. Дополнительные коды ошибок см. в разделе Константы ошибок WMI или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.
-
Успешно
-
0
Успешно.
-
доступ запрещен
-
2
Доступ запрещен.
-
Неуказанным сбоем
-
8
Неуказанным сбоем.
-
Недопустимый объект
-
9
Недопустимый объект.
-
Объект уже существует
-
10
Объект уже существует.
-
Файловая система не NTFS
-
11
-
Платформа не NT/Windows 2000
-
12
Платформа не Windows NT.
-
Диск не тот же
-
13
Диск не тот же.
-
Каталог не пуст
-
14
Каталог не пуст.
-
Нарушение общего доступа
-
15
Нарушение правил общего доступа.
-
Недопустимый начальный файл
-
16
Недопустимый начальный файл.
-
Привилегия не удерживаема
-
17
Привилегия не удерживаема.
-
недопустимый параметр.
-
21
Недопустимый параметр.
Комментарии
Метод ChangeSecurityPermissions в CIM_DataFile реализуется WMI.
Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|