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

Метод класса WMIChangeSecurityPermissions изменяет разрешения безопасности для логического файла ярлыка, указанного в пути к объекту. Если логический файл является каталогом, changeSecurityPermissions является рекурсивным и изменяет разрешения безопасности для всех файлов и подкаталогов, содержащихся в каталоге. ChangeSecurityPermissions возвращает целочисленное значение 0 (ноль) при изменении разрешений и другое число, указывающее на ошибку.

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

Синтаксис

uint32 ChangeSecurityPermissions(
  [in] Win32_SecurityDescriptor SecurityDescriptor,
  [in] uint32                   Option
);

Параметры

SecurityDescriptor [in]

Выражение, разрешающееся в экземпляр Win32_SecurityDescriptor. Этот дескриптор содержит новые разрешения безопасности для экземпляра Win32_PageFile.

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)

Измените список управления доступом на уровне пользователей (DACL) логического файла.

CHANGE_SACL_SECURITY_INFORMATION (8)

Измените системный список управления доступом (SACL) логического файла.

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

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

Успешно

0

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

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

2

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

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

8

Произошел неопределенный сбой.

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

9

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

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

10

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

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

11

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

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

12

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

Диск не тот же

13

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

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

14

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

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

15

Имеется нарушение общего доступа.

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

16

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

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

17

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

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

21

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

Требования

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

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

Win32_ShortcutFile