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

Статья
06/12/2023

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

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

Синтаксис

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

Параметры

FileName [in]

Полное имя копии файла (или каталога). Пример: c:\temp\newdirectory.

StopFileName [out]

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

StartFileName [in, необязательный]

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

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

Рекурсивный [in, необязательный]

Если значение равно true, файлы и каталоги будут рекурсивно скопированы в каталог, указанный экземпляром CIM_LogicalFile .

Примечание

Для экземпляров файлов параметр рекурсивных входных данных игнорируется.

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

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

0: Запрос выполнен успешно.
2: В доступе было отказано.
8: Произошла неуказаная ошибка.
9: Указанное имя было недопустимым.
10: Указанный объект уже существует.
11: Файловая система не является системой NTFS.
12: Платформа не является Windows.
13: Диск отличается.
14: Каталог не пуст.
15: Произошло нарушение общего доступа.
16: Указан недопустимый начальный файл.
17: Привилегия, необходимая для операции, не удерживается.
21: Указанный параметр недопустим.

Требования

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

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

Классы операционной системы
Win32_Directory

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