Renommer la méthode de la classe Win32_Directory

Article
06/12/2023

La méthode de classe RenameWMI renomme le fichier d’entrée de répertoire spécifié dans le chemin d’accès de l’objet. Un renommage n’est pas pris en charge si la destination se trouve sur un autre lecteur ou si le remplacement d’un fichier logique existant est nécessaire.

Cette rubrique utilise la syntaxe MOF (Managed Object Format). Pour plus d’informations sur l’utilisation de cette méthode, consultez Appel d’une méthode.

Syntaxe

uint32 Rename(
   string FileName
);

Paramètres

FileName: Nouveau nom complet du fichier (ou répertoire). Exemple : c:\temp\newfile.txt.

Valeur retournée

Retourne la valeur 0 (zéro) si le fichier a été renommé avec succès, et tout autre nombre pour indiquer une erreur.

0: La demande a abouti.
2: L’accès a été refusé.
8: Un échec non spécifié s’est produit.
9: Le nom spécifié n’était pas valide.
10: L’objet spécifié existe déjà.
11: Le système de fichiers n’est pas NTFS.
12: La plateforme n’est pas Windows.
13: Le lecteur n’est pas le même.
14: Le répertoire n'est pas vide.
15: Il y a eu une violation du partage.
16: Le fichier de démarrage spécifié n’était pas valide.
17: Un privilège requis pour l’opération n’est pas conservé.
21: Un paramètre spécifié n’est pas valide.

Notes

Pour renommer un dossier, commencez par le lier au dossier en question, puis appelez la méthode Rename. En tant que seul paramètre de la méthode, passez le nouveau nom du dossier comme nom de chemin d’accès complet. Par exemple, si le dossier dans C:\Scripts\Logs\Backup doit être renommé C:\Scripts\Archive, vous devez passer C:\Scripts\Archive comme nom complet du dossier. Le fait de passer uniquement le nom du dossier Archive génère une erreur de chemin d’accès non valide.

La classe Win32_Directory ne fournit pas de méthode en une étape pour déplacer des dossiers. Au lieu de cela, le déplacement d’un dossier implique généralement deux étapes :

1. Copie du dossier vers son nouvel emplacement 2. Suppression du dossier d’origine

La seule exception à ce processus en deux étapes consiste à déplacer un dossier vers un nouvel emplacement sur le même lecteur. Par exemple, supposons que vous souhaitiez déplacer C:\Temp vers C:\Scripts\Temporary Files\Archive. Tant que l’emplacement actuel et le nouvel emplacement se trouvent sur le même lecteur, vous pouvez déplacer le dossier en appelant simplement la méthode Rename et en transmettant le nouvel emplacement comme paramètre de méthode. Cette approche vous permet de déplacer le dossier en une seule étape. Toutefois, le script échoue si le lecteur actuel et le nouveau lecteur sont différents. Une tentative de renommage de C:\Temp en D:\Temp échoue avec une erreur « Le lecteur n’est pas le même ».

Exemples

Le code suivant, à partir de l’exemple Déplacer un dossier à l’aide de WMI VBScript sur TechNet Gallery, utilise la méthode Rename pour déplacer le dossier C:\Scripts vers C:\Admins\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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Espace de noms	Racine\CIMV2
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Voir aussi

Classes du système d’exploitation
Win32_Directory