Метод TakeOwnerShipEx класса Win32_CodecFile

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

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

Синтаксис

uint32 TakeOwnerShipEx(
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Параметры

StopFileName [out]

Имя файла или каталога, в котором произошел сбой метода TakeOwnerShipEx . Этот параметр будет иметь значение NULL , если метод будет выполнен успешно.

StartFileName [in, необязательный]

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

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

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

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

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

0

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

2

В доступе было отказано.

8

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

9

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

10

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

11

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

12

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

13

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

14

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

15

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

16

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

17

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

21

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

Требования

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

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

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

Win32_CodecFile