Méthode copy de la classe Win32_Directory
La méthode de classe WMICopy copie le fichier d’entrée de répertoire logique ou le répertoire spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre d’entrée. Une copie n’est pas prise en charge 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 Copy(
string FileName
);
Paramètres
-
FileName
-
Nom complet de la copie du fichier (ou du répertoire). Exemple : c:\temp\newdirectory
Valeur retournée
Retourne une valeur de 0 (zéro) si le fichier a été correctement copié, 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 de partage.
-
16
-
Le fichier de début spécifié n’était pas valide.
-
17
-
Aucun privilège requis pour l’opération n’est conservé.
-
21
-
Un paramètre spécifié n’est pas valide.
Notes
Les dossiers doivent souvent être copiés d’un emplacement à un autre. Par exemple, vous pouvez copier un dossier d’un serveur vers un autre pour créer une copie de sauvegarde de ce dossier. Vous pouvez également avoir un dossier de modèles qui doit être copié sur les stations de travail utilisateur, ou un dossier scripts qui doit être copié sur tous vos serveurs DNS.
La méthode Win32_Directory Copy vous permet de copier un dossier d’un emplacement vers un autre, soit sur le même ordinateur (par exemple, en copiant un dossier du lecteur C vers le lecteur D), soit sur un ordinateur distant. Pour copier un dossier, vous retournez une instance du dossier à copier, puis appelez la méthode Copy, en passant en tant que paramètre l’emplacement cible de la nouvelle copie du dossier. Par exemple, cette ligne de code copie un dossier dans le dossier Scripts sur le lecteur F :
objFolder.Copy("F:\Scripts")
WMI ne remplace pas un dossier existant lors de l’exécution de la méthode Copy. Cela signifie que l’opération de copie échoue si le dossier de destination existe. Par exemple, supposons que vous ayez un dossier nommé Scripts et que vous essayiez de copier ce dossier dans un partage distant nommé \\atl-fs-01\archive. Si un dossier nommé Scripts existe déjà sur ce partage, l’opération de copie échoue.
Exemples
L’exemple de code suivant, extrait de Copier un dossier à l’aide de WMI, utilise la méthode Copy pour copier le dossier C:\Scripts vers 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
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 |
|
| DLL |
|