Метод TakeOwnerShip класса CIM_Directory
Метод TakeOwnerShip получает право владения логическим файлом, указанным в пути к объекту. Если логический файл является каталогом, этот метод действует рекурсивно, принимая во владение все файлы и вложенные каталоги, содержащиеся в каталоге. Этот метод наследуется от CIM_LogicalFile.
Важно!
Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.
В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.
Синтаксис
uint32 TakeOwnerShip();
Параметры
Этот метод не имеет параметров.
Возвращаемое значение
Возвращает значение 0 (ноль) при успешном выполнении и любое другое число, указывающее на ошибку.
-
0
-
Успешно.
-
2
-
Доступ запрещен.
-
8
-
Неопределенный сбой.
-
9
-
Недопустимый объект.
-
10
-
Объект уже существует.
-
11
-
Файловая система не NTFS.
-
12
-
Платформа не является Windows.
-
13
-
Диск не то же самое.
-
14
-
Каталог не пуст.
-
15
-
Нарушение правил общего доступа.
-
16
-
Недопустимый начальный файл.
-
17
-
Привилегия не удерживаема.
-
21
-
Недопустимый параметр.
Комментарии
В настоящее время этот метод не реализуется инструментарием WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.
Эта документация взята из описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Пакету SDK Майкрософт или предоставления дополнительных сведений.
Примеры
Следующий код скрипта Visual Basic вызывает метод TakeOwnerShip , чтобы стать владельцем папки C:\temp.
strComputer = "."
Set objWMIService = _
GetObject("winmgmts:\\" & strComputer & "\root\CIMV2")
' Obtain the definition of the class.
Set objShare = objWMIService.Get("Win32_Directory")
' 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'", "TakeOwnerShip")
wscript.echo objOutParams.ReturnValue
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|