Metodo Copy della classe Win32_Directory

Articolo
11/30/2023

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	CIMWin32.mof
DLL	CIMWin32.dll

Vedi anche

Classi del sistema operativo
Win32_Directory