Partager via

CopyFileFromAppW, fonction (fileapifromapp.h)

  • Article

Copie un fichier existant vers un nouveau fichier. Le comportement de cette fonction est identique à celui de CopyFile, à ceci près que cette fonction adhère au modèle de sécurité des applications plateforme Windows universelle.

Syntaxe

WINSTORAGEAPI BOOL CopyFileFromAppW(
  LPCWSTR lpExistingFileName,
  LPCWSTR lpNewFileName,
  BOOL    bFailIfExists
) noexcept;

Paramètres

lpExistingFileName

Nom d’un fichier existant.

Pour plus d’informations sur la désactivation de la limitation de MAX_PATH sans passer à la limite « \??\ », consultez la section « Limitation de longueur maximale du chemin d’accès » de l’article Nommage des fichiers, des chemins et des espaces de noms .

Si lpExistingFileName n’existe pas, la fonction échoue et GetLastError retourne ERROR_FILE_NOT_FOUND.

lpNewFileName

Nom du nouveau fichier.

Dans la version ANSI de cette fonction, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères de large, appelez la version Unicode de la fonction et ajoutez « \?\ » au chemin d’accès. Pour plus d’informations, consultez Nommer un fichier.

Pour la version Unicode de cette fonction (CopyFileFromAppW), vous pouvez choisir de supprimer la limitation MAX_PATH sans avoir à précédencer « \?\ ». Pour plus d’informations, consultez la section « Limitation de longueur maximale du chemin d’accès » dans Naming Files, Paths et Namespaces .

bFailIfExists

Si ce paramètre a la valeur TRUE et que le nouveau fichier spécifié par lpNewFileName existe déjà, la fonction échoue. Si ce paramètre a la valeur FALSE et que le nouveau fichier existe déjà, la fonction remplace le fichier existant et réussit.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

   
Client minimal pris en charge Windows 10 version 1803
En-tête fileapifromapp.h