Rinominare il metodo della classe Win32_Directory

Articolo
11/30/2023

Il metodo Rinomina classe WMI rinominail file di immissione della directory specificato nel percorso dell'oggetto. Una ridenominazione non è supportata se la destinazione si trova in un'altra unità o 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 Rename(
   string FileName
);

Parametri

FileName: Nuovo nome completo del file (o directory). Esempio: c:\temp\newfile.txt.

Valore restituito

Restituisce un valore pari a 0 (zero) se il file è stato rinominato 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:

Per rinominare una cartella, associarla prima alla cartella in questione e quindi chiamare il metodo Rename. Come unico parametro del metodo, passare il nuovo nome per la cartella come nome di percorso completo. Ad esempio, se la cartella in C:\Scripts\Logs\Backup deve essere rinominata C:\Scripts\Archive, è necessario passare C:\Scripts\Archive come nome completo della cartella. Se si passa solo il nome della cartella - Archivio , viene restituito un errore percorso non valido.

La classe Win32_Directory non fornisce un metodo in un unico passaggio per lo spostamento delle cartelle. Lo spostamento di una cartella prevede in genere due passaggi:

1. Copia della cartella nel nuovo percorso 2. Eliminazione della cartella originale

L'unica eccezione a questo processo in due passaggi comporta lo spostamento di una cartella in una nuova posizione nella stessa unità. Si supponga, ad esempio, di voler spostare C:\Temp in C:\Scripts\Temporary Files\Archive. Finché il percorso corrente e il nuovo percorso si trovano nella stessa unità, è possibile spostare la cartella semplicemente chiamando il metodo Rename e passando il nuovo percorso come parametro del metodo. Questo approccio consente di spostare la cartella in un singolo passaggio. Tuttavia, lo script ha esito negativo se l'unità corrente e la nuova unità sono diverse. Un tentativo di rinominare C:\Temp in D:\Temp ha esito negativo con un errore "Unità non uguale".

Esempi

Il codice seguente usa il metodo Rename per spostare la cartella C:\Scripts in C:\Amministrazione s\Documents\Archive\VBScript.

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.Rename("C:\Admins\Documents\Archive\VBScript") 
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

Condividi tramite