Метод Такеовнершипекс _ класса каталога Win32

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

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

Синтаксис

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

Параметры

Стопфиленаме [ заполняет]

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

StartFileName [ в необязательное]

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

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

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

Если значение — true, изменение владельца применяется рекурсивно к файлам и каталогам в каталоге, указанном в экземпляре CIM _ LogicalFile .

Примечание

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

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

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

0

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

2

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

8

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

9

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

10

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

11

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

12

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

13

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

14

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

15

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

16

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

17

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

открыт

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

Примеры

следующий код скрипта Visual Basic вызывает метод такеовнершипекс , чтобы стать владельцем папки 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
Пространство имен
Корневой \ CIMV2
MOF
CIMWin32. mof
DLL
CIMWin32.dll

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

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

_Каталог Win32