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

Статья
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.

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

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

Примечание

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

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

Возвращает значение 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_PageFile

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