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

Статья
06/12/2023

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

Поделиться через