Méthode CopyEx de la classe Win32_Directory

La méthode de classe WMICopyEx copie le fichier ou le répertoire d’entrée de répertoire logique spécifié dans le chemin d’accès de l’objet à l’emplacement spécifié par le paramètre FileName. Cette méthode est une version étendue de la méthode Copy . 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 CopyEx(
  [in]           string  FileName,
  [out]          string  StopFileName,
  [in, optional] string  StartFileName,
  [in, optional] boolean Recursive
);

Paramètres

FileName [in]

Nom complet de la copie du fichier (ou du répertoire). Exemple : c:\temp\newdirectory.

StopFileName [out]

Nom du fichier ou du répertoire où la méthode CopyEx a échoué. Ce paramètre sera null si la méthode réussit.

StartFileName [in, optional]

Nomme le fichier ou répertoire enfant à utiliser comme point de départ pour CopyEx. Le paramètre StartFileName est généralement le paramètre StopFileName qui spécifie le fichier ou le répertoire dans lequel une erreur s’est produite à partir de l’appel de méthode précédent. Si ce paramètre a la valeur NULL, l’opération est effectuée sur le fichier ou le répertoire spécifié dans l’appel ExecMethod .

Si StartFileName est utilisé, Recursive doit également avoir la valeur true.

Récursive [in, facultatif]

Si la valeur est true, les fichiers et les répertoires sont copiés de manière récursive dans le répertoire spécifié par le CIM_LogicalFile instance.

Notes

Pour les instances de fichier, le paramètre d’entrée récursive est ignoré.

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.

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