Metodo CopyEx della classe Win32_Directory
Il metodo della classe CopyEx WMI copia il file di voce della directory logica o la directory specificata nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro FileName. Questo metodo è una versione estesa del metodo Copy . Una copia non è supportata se è necessaria la sovrascrittura di un file logico esistente.
Questo argomento usa la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 CopyEx(
[in] string FileName,
[out] string StopFileName,
[in, optional] string StartFileName,
[in, optional] boolean Recursive
);
Parametri
-
FileName [in]
-
Nome completo della copia del file (o directory). Esempio: c:\temp\newdirectory.
-
StopFileName [out]
-
Nome del file o della directory in cui il metodo CopyEx non è riuscito. Questo parametro sarà Null se il metodo ha esito positivo.
-
StartFileName [in, facoltativo]
-
Assegna un nome al file figlio o alla directory da usare come punto di partenza per CopyEx. Il parametro StartFileName è in genere il parametro StopFileName che specifica il file o la directory in cui si è verificato un errore dalla chiamata al metodo precedente. Se questo parametro è NULL, l'operazione viene eseguita nel file o nella directory specificata nella chiamata ExecMethod .
Se viene usato StartFileName, è necessario impostare anche su true.
-
Ricorsivo [in, facoltativo]
-
Se true, i file e le directory verranno copiati in modo ricorsivo all'interno della directory specificata dall'istanza di CIM_LogicalFile .
Nota
Per le istanze di file, il parametro di input ricorsivo viene ignorato.
Valore restituito
Restituisce un valore pari a 0 (zero) se il file è stato copiato correttamente e qualsiasi altro numero per indicare un errore.
-
0
-
La richiesta è stata completata.
-
2
-
L'accesso è stato negato.
-
8
-
Si è verificato un errore non specificato.
-
9
-
Il nome specificato non è valido.
-
10
-
L'oggetto specificato esiste già.
-
11
-
Il file system non è NTFS.
-
12
-
La piattaforma non è Windows.
-
13
-
L'unità non è la stessa.
-
14
-
La directory non è vuota.
-
15
-
C'è stata una violazione della condivisione.
-
16
-
Il file di avvio specificato non è valido.
-
17
-
Non viene mantenuto un privilegio necessario per l'operazione.
-
21
-
Un parametro specificato non è valido.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Radice\CIMV2 |
| MOF |
|
| DLL |
|