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

Статья
06/13/2023

Метод класса WMI ChangeSecurityPermissionsEx изменяет разрешения безопасности для файла записи каталога, указанного в пути к объекту (этот метод является расширенной версией метода 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.

Параметр [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 — это параметр StopFileName , указывающий файл или каталог, в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется с файлом или каталогом, указанным в вызове ExecMethod . Этот параметр является необязательным.

Если используется Параметр StartFileName , для параметра Recursive также должно быть задано значение true.

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

Если значение равно true, изменение владельца применяется рекурсивно к файлам и каталогам в каталоге, указанном экземпляром CIM_LogicalFile . Для экземпляров файлов параметр рекурсивных входных данных игнорируется. Этот параметр является необязательным.

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

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

Успешно

Запрос выполнен успешно.

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

Отказано в доступе".

Неуказанным сбоем

Произошла неуказаная ошибка.

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

Указанное имя недопустимо.

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

Указанный объект уже существует.

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

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

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

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

Диск не тот же

Диск отличается.

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

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

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

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

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

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

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

Привилегия, необходимая для операции, не удерживается.

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

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

Требования

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

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

Классы операционной системы
Win32_Directory

Share via