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

Статья
06/03/2023

Метод ChangeSecurityPermissionsEx изменяет разрешения безопасности для файла устройства, указанного в пути к объекту (этот метод является расширенной версией метода ChangeSecurityPermissions ). Если логический файл является каталогом, этот метод действует рекурсивно, изменяя разрешения безопасности для всех файлов и вложенных каталогов, содержащихся в каталоге. Этот метод наследуется от CIM_LogicalFile.

Важно!

Классы CIM (Common Information Model) dmTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версий CIM 2.x.

В этом разделе используется синтаксис MOF. Дополнительные сведения об использовании этого метода см. в разделе "Вызов метода".

Синтаксис

uint32 ChangeSecurityPermissionsEx(
  [in]           Win32_SecurityDescriptor SecurityDescriptor,
  [in]           uint32                   Option,
  [out]          string                   StopFileName,
  [in, optional] string                   StartFileName,
  [in, optional] boolean                  Recursive
);

Параметры

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 логического файла.

StopFileName [out]

Строка, представляющая имя файла (или каталога), в котором произошел сбой метода. Этот параметр имеет значение NULL , если метод завершается успешно.

StartFileName [in, optional]

Дочерний файл (или каталог) для использования в качестве отправной точки для этого метода. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл или каталог, в котором произошла ошибка из предыдущего вызова метода. Если этот параметр имеет значение NULL, операция выполняется в файле (или каталоге), указанном в вызове ExecMethod .

Рекурсивный [in, необязательный]

Если значение РАВНО TRUE, метод также применяется рекурсивно к файлам и каталогам в каталоге, указанном экземпляром CIM_DeviceFile . Для экземпляров файлов этот параметр игнорируется.

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

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

Успешно.

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

Неуказанный сбой.

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

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

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

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

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

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

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

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

Привилегии не удерживались.

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

Remarks

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

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

Требования

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

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

CIM_DeviceFile
CIM_DeviceFile

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