DeleteFileTransactedW, fonction (winbase.h)

  • Article

[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios pour utilisant TxF peuvent être réalisés à l’aide de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les versions futures de Microsoft Windows. Pour plus d’informations et les alternatives à TxF, consultez Alternatives à l’utilisation de NTFS transactionnel.]

Supprime un fichier existant en tant qu’opération traitée.

Syntaxe

BOOL DeleteFileTransactedW(
  [in] LPCWSTR lpFileName,
  [in] HANDLE  hTransaction
);

Paramètres

[in] lpFileName

Nom du fichier à supprimer.

Le fichier doit résider sur l’ordinateur local ; sinon, la fonction échoue et le dernier code d’erreur est défini sur ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE.

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

Conseil

À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation MAX_PATH sans précédencer « \\?\ ». Pour plus d’informations, consultez la section « Limitation maximale de la longueur du chemin d’accès » de Naming Files, Paths et Namespaces .

[in] hTransaction

Handle de la transaction. Ce handle est retourné par la fonction CreateTransaction .

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

Notes

Si une application tente de supprimer un fichier qui n’existe pas, la fonction DeleteFileTransacted é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 identifie quelques conseils pour supprimer, supprimer ou fermer des fichiers :

  • Pour supprimer un fichier en lecture seule, vous devez d’abord supprimer l’attribut lecture seule.
  • Pour supprimer ou renommer un fichier, vous devez disposer d’une autorisation de suppression sur le fichier ou d’une 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 RemoveDirectoryTransacted .
  • Pour fermer un fichier ouvert, utilisez la fonction CloseHandle .
Si vous configurez un répertoire avec tous les accès à l’exception de la suppression et de la suppression d’enfants, 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 tous les accès que vous demandez sur le handle qui vous est retourné au moment de la création du fichier.

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

La fonction DeleteFileTransacted échoue si une application tente de supprimer un fichier qui a d’autres handles 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 DeleteFileTransacted marque un fichier à supprimer lors de la fermeture. Le fichier est supprimé après la fermeture du dernier handle d’enregistreur traité dans le fichier, à condition que la transaction soit toujours active. Si un fichier a été marqué pour suppression et qu’un handle d’enregistreur traité est toujours ouvert une fois la transaction terminée, le fichier n’est pas supprimé.

Liens symboliques : Si le chemin pointe vers un lien symbolique, le lien symbolique est supprimé, et non 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.

Technologie Prise en charge
Protocole SMB (Server Message Block) 3.0 Non
Basculement transparent (TFO) SMB 3.0 Non
SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO) Non
Cluster Shared Volume File System (CsvFS) Non
Système de fichiers résilient (ReFS) Non
 

SMB 3.0 ne prend pas en charge TxF.

Notes

L’en-tête winbase.h définit DeleteFileTransacted comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CloseHandle

CreateFileTransacted

Fonctions de gestion de fichiers

Liens symboliques

NTFS transactionnel