Metodo Copy della classe Win32_Directory
Il metodo copyWMI class copia il file di immissione della directory logica o la directory specificata nel percorso dell'oggetto nel percorso dell'oggetto specificato dal parametro di input. Una copia non è supportata se è necessaria la sovrascrittura di un file logico esistente.
In questo argomento viene utilizzata la sintassi MOF (Managed Object Format). Per altre informazioni sull'uso di questo metodo, vedere Chiamata di un metodo.
Sintassi
uint32 Copy(
string FileName
);
Parametri
-
FileName
-
Nome completo della copia del file (o della directory). Esempio: c:\temp\newdirectory
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
-
Accesso 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 di condivisione.
-
16
-
Il file iniziale specificato non è valido.
-
17
-
Un privilegio necessario per l'operazione non viene mantenuto.
-
21
-
Un parametro specificato non è valido.
Osservazioni:
Spesso le cartelle devono essere copiate da una posizione a un'altra. Ad esempio, è possibile copiare una cartella da un server a un altro per creare una copia di backup di tale cartella. In alternativa, potrebbe essere disponibile una cartella di modelli che deve essere copiata nelle workstation utente o una cartella di script che deve essere copiata in tutti i server DNS.
Il metodo Copy Win32_Directory consente di copiare una cartella da un percorso a un altro, nello stesso computer (ad esempio, copiando una cartella dall'unità C all'unità D) o in un computer remoto. Per copiare una cartella, si restituisce un'istanza della cartella da copiare e quindi si chiama il metodo Copy, passando come parametro il percorso di destinazione per la nuova copia della cartella. Ad esempio, questa riga di codice copia una cartella nella cartella Scripts nell'unità F:
objFolder.Copy("F:\Scripts")
WMI non sovrascriverà una cartella esistente durante l'esecuzione del metodo Copy. Ciò significa che l'operazione di copia ha esito negativo se la cartella di destinazione esiste. Si supponga, ad esempio, di avere una cartella denominata Scripts e di tentare di copiare tale cartella in una condivisione remota denominata \\atl-fs-01\archive. Se esiste già una cartella denominata Scripts in tale condivisione, l'operazione di copia non riesce.
Esempi
L'esempio di codice seguente usa il metodo Copy per copiare la cartella C:\Scripts in D:\Archive.
strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
& "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colFolders = objWMIService.ExecQuery( _
"Select * from Win32_Directory where Name = 'c:\\Scripts'")
For Each objFolder in colFolders
errResults = objFolder.Copy("D:\Archive")
Next
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Root\CIMV2 |
| MOF |
|
| DLL |
|