DeleteFileA, fonction (fileapi.h)

Supprime un fichier existant.

Pour effectuer cette opération en tant qu’opération transactionnelle, utilisez la fonction DeleteFileTransacted .

Syntaxe

BOOL DeleteFileA(
  [in] LPCSTR lpFileName
);

Paramètres

[in] lpFileName

Nom du fichier à supprimer.

Par défaut, le nom est limité à MAX_PATH caractères. Pour étendre cette limite à 32 767 caractères de large, ajoutez « \\ ?\ » au chemin d’accès. Pour plus d’informations, consultez Nommage de fichiers, de chemins et d’espaces de noms.

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 (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Si une application tente de supprimer un fichier qui n’existe pas, la fonction DeleteFile échoue avec ERROR_FILE_NOT_FOUND. Si le fichier est un fichier en lecture seule, la fonction échoue avec ERROR_ACCESS_DENIED.

La liste suivante répertorie quelques conseils pour supprimer, supprimer ou fermer des fichiers :

• Pour supprimer un fichier en lecture seule, vous devez d’abord supprimer l’attribut en lecture seule.
• Pour supprimer ou renommer un fichier, vous devez disposer de l’autorisation supprimer sur le fichier ou supprimer l’autorisation enfant dans le répertoire parent.
• Pour supprimer de manière récursive les fichiers d’un répertoire, utilisez la fonction SHFileOperation .
• Pour supprimer un répertoire vide, utilisez la fonction RemoveDirectory .
• Pour fermer un fichier ouvert, utilisez la fonction CloseHandle .

Si vous configurez un répertoire avec tous les accès à l’exception de delete et delete child, et que les listes de contrôle d’accès (ACL) de nouveaux fichiers sont héritées, vous pouvez créer un fichier sans pouvoir le supprimer. Toutefois, vous pouvez créer un fichier, puis obtenir tout l’accès que vous demandez sur le handle qui vous est retourné au moment où vous créez le fichier.

Si vous demandez l’autorisation de suppression au moment où vous créez un fichier, vous pouvez supprimer ou renommer le fichier avec ce handle, mais pas avec un autre handle. Pour plus d’informations, consultez Sécurité des fichiers et droits d’accès.

La fonction DeleteFile échoue si une application tente de supprimer un fichier qui a d’autres descripteurs ouverts pour les E/S normales ou en tant que fichier mappé en mémoire (FILE_SHARE_DELETE doit avoir été spécifié lors de l’ouverture d’autres handles).

La fonction DeleteFile marque un fichier à supprimer à la fermeture. Par conséquent, la suppression du fichier n’a pas lieu tant que le dernier handle du fichier n’est pas fermé. Les appels suivants à CreateFile pour ouvrir le fichier échouent avec ERROR_ACCESS_DENIED.

L’utilisation de la suppression POSIX entraîne la suppression du fichier pendant que les handles restent ouverts. Les appels suivants à CreateFile pour ouvrir le fichier échouent avec ERROR_FILE_NOT_FOUND.

Comportement des liens symboliques :

Si le chemin pointe vers un lien symbolique, ce lien symbolique est supprimé, mais pas la cible. Pour supprimer une cible, vous devez appeler CreateFile et spécifier FILE_FLAG_DELETE_ON_CLOSE.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes :

Exemples

Pour obtenir un exemple, consultez Verrouillage et déverrouillage de plages d’octets dans des fichiers.

Configuration requise

Voir aussi

CloseHandle

CreateFile

DeleteFileTransacted

Fonctions de gestion des fichiers

Liens symboliques