Метод CopyEx класса CIM_LogicalFile
Метод CopyEx копирует логический файл (или каталог), указанный в пути к объекту, в расположение, указанное параметром FileName . Копирование не поддерживается, если требуется перезапись существующего логического файла. Этот метод является расширенной версией метода Copy .
Важно!
Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых создаются классы WMI. В настоящее время WMI поддерживает только схемы версии CIM 2.x.
В этом разделе используется синтаксис формата управляемого объекта (MOF). Дополнительные сведения об использовании этого метода см. в разделе Вызов метода.
Синтаксис
uint32 CopyEx(
[in] string FileName,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Параметры
-
FileName [in]
-
Полное имя целевого файла (или каталога).
Пример: "c:\temp\newdirectory"
-
StopFileName [out]
-
Строка, представляющая имя файла (или каталога), в котором произошел сбой метода. Этот параметр имеет значение NULL , если метод выполнен успешно.
-
StartFileName [in, необязательный]
-
Строка, именующая дочерний файл (или каталог), используемый в качестве отправной точки для этого метода. Как правило, параметр StartFileName — это параметр StopFileName , указывающий файл (или каталог), в котором произошла ошибка при предыдущем вызове метода. Если этот параметр имеет значение NULL, операция выполняется в файле или каталоге, указанном в вызове ExecMethod .
-
Рекурсивный [in, необязательный]
-
Если задано значение TRUE, метод также рекурсивно применяется к файлам и каталогам в каталоге, указанном экземпляром CIM_LogicalFile . Для экземпляров файлов этот параметр игнорируется.
Возвращаемое значение
Возвращает значение 0 (ноль) при успешном выполнении и любое другое число, указывающее на ошибку.
-
Успешно
-
0
Успешно.
-
доступ запрещен
-
2
Доступ запрещен.
-
Неопределенный сбой
-
8
Неопределенный сбой.
-
Недопустимый объект
-
9
Недопустимый объект.
-
Объект уже существует
-
10
Объект уже существует.
-
Файловая система не NTFS
-
11
Файловая система не NTFS.
-
Платформа, не NT/Windows 2000
-
12
Платформа, а не Windows.
-
Диск не тот же
-
13
Диск не то же самое.
-
Каталог не пуст
-
14
Каталог не пуст.
-
Нарушение общего доступа
-
15
Нарушение правил общего доступа.
-
Недопустимый начальный файл
-
16
Недопустимый начальный файл.
-
Привилегия не удерживаема
-
17
Привилегия не удерживаема.
-
недопустимый параметр.
-
21
Недопустимый параметр.
Комментарии
В настоящее время этот метод не реализуется инструментарием WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.
Эта документация взята из описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Пакету SDK Майкрософт или предоставления дополнительных сведений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista |
| Минимальная версия сервера |
Windows Server 2008 |
| Пространство имен |
Root\CIMV2 |
| MOF |
|
| DLL |
|