Renommer la méthode de la _ classe Directory Win32
La méthode de la classe Renommer WMI renomme le fichier d’entrée de répertoire spécifié dans le chemin d’accès de l’objet. Un changement de nom 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 format MOF (MOF). 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 de retour
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
-
Une erreur non spécifiée s’est produite.
-
9
-
Le nom spécifié n’est 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
-
Une violation de partage s’est produite.
-
16
-
Le fichier de démarrage spécifié n’est 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 lier le dossier en question, puis appelez la méthode Rename. Comme seul paramètre de la méthode, transmettez le nouveau nom du dossier sous la forme d’un nom de chemin d’accès complet. Par exemple, si le dossier de la \ sauvegarde journaux c : scripts doit \ \ être renommé en c : \ scripts \ Archive, vous devez passer l’archive c : \ scripts \ comme nom de dossier complet. Le passage uniquement du nom de dossier-archive-génère une erreur de chemin d’accès non valide.
La _ classe de répertoire Win32 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 implique le déplacement d’un dossier vers un nouvel emplacement sur le même lecteur. Supposons, par exemple, que vous souhaitiez déplacer l' \ Archive de fichiers temporaires c : Temp vers c : \ scripts \ \ . 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 passant le nouvel emplacement en tant que 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 actif et le nouveau lecteur sont différents. Une tentative de changement de nom de C : \ temp en D : \ temp échoue avec une erreur « lecteur non identique ».
Exemples
Le code suivant, extrait de l’exemple de déplacement d’un dossier à l’aide de VBScript WMI sur la Galerie TechNet, 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 |
\Cimv2 racine |
| MOF |
|
| DLL |
|