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

Статья
06/12/2023

Метод 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]: Строка, представляющая дочерний файл (или каталог), используемый в качестве отправной точки для этого метода. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл или каталог, в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется с файлом или каталогом, указанным в вызове ExecMethod .
Рекурсивный [в]: Если задано значение TRUE, метод также рекурсивно применяется к файлам и каталогам в каталоге, указанном экземпляром CIM_DeviceFile . Для экземпляров файлов этот параметр игнорируется.

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

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

Успешно.

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

Неуказанным сбоем.

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

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

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

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

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

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

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

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

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

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Пространство имен	Root\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

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

CIM_DeviceFile
CIM_DeviceFile

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