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

Метод класса 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 .

Если используется Параметр StartFileName , для параметра Recursive также должно быть задано значение 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