Método CopyEx de la clase Win32_ShortcutFile
El método de clase WMICopyEx copia el archivo de método abreviado lógico o directorio especificado en la ruta de acceso al objeto a la ubicación especificada por el parámetro FileName. Este método es una versión extendida del método Copy . No se admite una copia si se requiere sobrescribir un archivo lógico existente.
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 StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parámetros
-
FileName [in]
-
Nombre completo de la copia del archivo (o directorio).
Ejemplo: c:\temp\newdirectory.
-
StopFileName [out]
-
Nombre del archivo o directorio en el que se produjo un error en el método CopyEx . Este parámetro es NULL si el método se realiza correctamente.
-
StartFileName [in, opcional]
-
Asigna un nombre al archivo o directorio secundario que se usará como punto de partida para CopyEx. El parámetro StartFileName suele ser el parámetro StopFileName que especifica el archivo o directorio en el que se produjo un error en 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.
-
Recursiva [in, opcional]
-
Si es true, el cambio de propiedad se aplicará de forma recursiva a los archivos y directorios del directorio especificado por la instancia de CIM_LogicalFile .
Nota
En el caso de las instancias de archivo, se omite el parámetro de entrada recursivo .
Valor devuelto
Devuelve un valor de 0 (cero) si el archivo se copió correctamente y cualquier otro número para indicar un error.
-
0
-
La solicitud fue correcta.
-
2
-
Se denegó el acceso.
-
8
-
Error no especificado.
-
9
-
El nombre especificado no era válido.
-
10
-
El objeto especificado ya existe.
-
11
-
El sistema de archivos no es NTFS.
-
12
-
La plataforma no es Windows.
-
13
-
La unidad no es la misma.
-
14
-
El directorio no está vacío.
-
15
-
Ha habido una infracción de uso compartido.
-
16
-
El archivo de inicio especificado no era válido.
-
17
-
No se mantiene un privilegio necesario para la operación.
-
21
-
Un parámetro especificado no es válido.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Espacio de nombres |
Root\CIMV2 |
| MOF |
|
| Archivo DLL |
|