Méthode CopyEx de la classe Win32_CodecFile

La méthode de classe WMICopyEx copie le fichier de codec logique ou le répertoire 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 .

Récursive [in, facultatif]

Si la valeur est true, le changement de propriété est appliqué de manière récursive aux fichiers et répertoires 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_CodecFile