Método CopyEx de la clase CIM_DataFile
El método CopyEx copia el archivo 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 requiere sobrescribir un archivo lógico existente. Este método es una versión extendida del método Copy y se hereda de CIM_LogicalFile.
Importante
Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.
En este tema se usa la sintaxis de Managed Object Format (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 [in]
-
Nombre completo del archivo de destino (o directorio).
Ejemplo: "c:\temp\newdirectory"
-
StopFileName [out]
-
Cadena que representa el nombre del archivo (o directorio) donde se produjo un error en el método. Este parámetro será null si el método se realiza correctamente.
-
StartFileName [in]
-
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 desde 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 ExecMethod .
Si se usa StartFileName , Recursive también debe establecerse en true.
-
Recursiva [in]
-
Si es TRUE, el método también se aplica de forma recursiva a archivos y directorios dentro del directorio especificado por la instancia de CIM_DataFile . 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. Para obtener códigos de error adicionales, consulte Constantes de error WMI o WbemErrorEnum. Para obtener valores HRESULT generales, consulte Códigos de error del sistema.
-
0
Correcto.
-
2
Acceso denegado.
-
8
Error no especificado.
-
9
Objeto no válido.
-
10
El objeto ya existe.
-
11
Sistema de archivos no 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
No se mantiene el privilegio.
-
21
Parámetro no válido.
Comentarios
WMI implementa el método CopyEx en CIM_DataFile .
Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK 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 |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|