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

Voir aussi

Classes du système d’exploitation

_Répertoire Win32