Método CopyEx de la clase _ DeviceFile de CIM

El método CopyEx copia el archivo de dispositivo lógico (o directorio) especificado en la ruta de acceso del objeto a la ubicación especificada por el parámetro FileName. No se admite una copia si se requiere sobrescribir un archivo lógico existente. Este método es una versión extendida del método Copy. Este método se hereda de CIM _ LogicalFile.

Importante

Las clases CIM (Modelo de información común) DMTF (Distributed Management Task Force) son las clases primarias en las que se han creado las clases WMI. WMI admite actualmente solo los esquemas de versión CIM 2.x.

En este tema se usa Managed Object Format sintaxis MOF . Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

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

Parámetros

FileName [ En]

Nombre completo del archivo de destino (o directorio).

Ejemplo: "c: \ temp \ newdirectory"

StopFileName [ out]

Cadena que representa el nombre del archivo (o directorio) en el que se ha fallado el método. Este parámetro es NULL si el método se realiza correctamente.

StartFileName [ En]

Cadena que representa el archivo secundario (o directorio) que se va a usar como punto de partida para este método. Normalmente, el parámetro StartFileName es el parámetro StopFileName que especifica el archivo o directorio en el que se produjo un error de la llamada al método anterior. Si este parámetro es null, la operación se realiza en el archivo (o directorio) especificado en la llamada a ExecMethod.

Recursivo [ En]

Si es TRUE, el método también se aplica de forma recursiva a los archivos y directorios dentro del directorio especificado por la instancia _ de DeviceFile de CIM. En el caso de las instancias de archivo, este parámetro se omite.

Valor devuelto

Devuelve un valor de 0 (cero) si se ejecuta correctamente y cualquier otro número para indicar un error.

0

Correcto.

2

Acceso denegado.

8

Error no especificado.

9

Objeto no válido.

10

El objeto ya existe.

11

El sistema de archivos no es NTFS.

12

Plataforma no Windows.

13

La unidad no es la misma.

14

El directorio no está vacío.

15

Infracción de uso compartido.

16

Archivo de inicio no válido.

17

Privilegios no mantenidos.

21

Parámetro no válido.

Observaciones

Wmi no implementa actualmente este método. Para usar este método, debe implementarlo en su propio proveedor.

Esta documentación se deriva de las descripciones de clases CIM publicadas por dmtf. Microsoft puede haber realizado cambios para corregir errores menores, ajustarse a los estándares de documentación del SDK de Microsoft o proporcionar más información.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008
Espacio de nombres
\CIMV2 raíz
MOF
CIMWin32.mof
Archivo DLL
CIMWin32.dll

Consulte también

CIM _ DeviceFile

CIM _ DeviceFile