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

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

Важно!

Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.

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

Синтаксис

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

Параметры

StopFileName [out]

Строка, представляющая имя файла (или каталога), в котором произошел сбой метода. Этот параметр имеет значение NULL, если метод выполнен успешно.

StartFileName [in]

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

Рекурсивный [вход]

При значении True метод применяется рекурсивно к файлам и каталогам в каталоге, указанном экземпляром CIM_Directory . Для экземпляров файлов этот параметр игнорируется.

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

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

0

Успешно.

2

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

8

Неопределенный сбой.

9

Недопустимый объект.

10

Объект уже существует.

11

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

12

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

13

Диск не то же самое.

14

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

15

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

16

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

17

Привилегия не удерживаема.

21

Недопустимый параметр.

Комментарии

В настоящее время этот метод не реализуется инструментарием WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.

Эта документация взята из описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Пакету SDK Майкрософт или предоставления дополнительных сведений.

Примеры

Следующий код скрипта 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

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

CIM_Directory

CIM_Directory