Méthode CopyEx de la classe Win32_PageFile

Article
06/12/2023

La méthode de classe WMICopyEx copie le fichier de pagination 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 a la valeur 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 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_PageFile

Partager via