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

Метод ChangeSecurityPermissions класса CIM_DeviceFile

  • Статья

Метод 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 предоставляет неограниченный доступ.

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)

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

CHANGE_SACL_SECURITY_INFORMATION (8)

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

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

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

Успешно

0

Успешно.

доступ запрещен

2

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

Неопределенный сбой

8

Неопределенный сбой.

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

9

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

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

10

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

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

11

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

Платформа, не NT/Windows 2000

12

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

Диск не тот же

13

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

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

14

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

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

15

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

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

16

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

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

17

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

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

21

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

Комментарии

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

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

Требования

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

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

CIM_DeviceFile

CIM_DeviceFile