Метод CopyEx класса CIM_DataFile

Статья
06/12/2023

Метод CopyEx копирует логический файл (или каталог), указанный в пути к объекту, в расположение, указанное параметром FileName . Копирование не поддерживается, если требуется перезапись существующего логического файла. Этот метод является расширенной версией метода Copy и наследуется от CIM_LogicalFile.

Важно!

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

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

Синтаксис

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

Параметры

FileName [in]

Полное имя целевого файла (или каталога).

Пример: "c:\temp\newdirectory"

StopFileName [out]

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

StartFileName [in]

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

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

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

Если значение РАВНО TRUE, метод также рекурсивно применяется к файлам и каталогам в каталоге, указанном экземпляром CIM_DataFile . Для экземпляров файлов этот параметр игнорируется.

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

Возвращает значение 0 (ноль) при успешном выполнении и любое другое число, указывающее на ошибку. Дополнительные коды ошибок см. в разделе WMI Error Constants или WbemErrorEnum. Общие значения HRESULT см. в разделе Системные коды ошибок.

Успешно.

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

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

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

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

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

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

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

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

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

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

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

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

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

Требования

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

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

CIM_DataFile
Задачи WMI: файлы и папки
Константы прав доступа к файлам и каталогам

Share via