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

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

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

Синтаксис

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

Параметры

StopFileName [out]

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

StartFileName [in, optional]

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

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

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

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

Примечание

Для экземпляров файлов рекурсивный входной параметр игнорируется.

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

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

0

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

2

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

8

Произошел неуказанный сбой.

9

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

10

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

11

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

12

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

13

Диск не совпадает.

14

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

15

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

16

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

17

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

21

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

Примеры

Следующий Visual Basic код скрипта вызывает метод TakeOwnerShipEx для владения папкой C:\temp.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:\\" & strComputer & "\root\CIMV2") 
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' Obtain an InParameters object specific
' to the method.
Set objInParam = objShare.Methods_("TakeOwnerShipEx").inParameters.SpawnInstance_()

' Add the input parameters.
objInParam.Properties_.Item("Recursive") =  true

' Execute the method and obtain the return status.
' The OutParameters object in objOutParams
' is created by the provider.
Set objOutParams = objWMIService.ExecMethod("Win32_Directory.Name='C:\Temp'", "TakeOwnerShipEx", objInParam)
wscript.echo objOutParams.ReturnValue

Требования

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

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

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

Win32_Directory