RemoveDirectory2A, fonction (fileapi.h)

Supprime un répertoire vide existant. Cette fonction échoue si une partie de lpPathName est redirigée via un point d’analyse ou un lien symbolique.

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

Syntaxe

BOOL RemoveDirectory2A(
  LPCSTR          lpPathName,
  DIRECTORY_FLAGS DirectoryFlags
);

Paramètres

lpPathName

Chemin d’accès du répertoire à supprimer. Ce chemin d’accès doit spécifier un répertoire vide, et le processus appelant doit avoir un accès suppression au répertoire.

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 des fichiers, des chemins et des espaces de noms.

DirectoryFlags

Indicateurs qui spécifient la façon dont le répertoire doit être supprimé. Ce paramètre peut être une combinaison des valeurs suivantes :

Valeur de retour

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’erreur étendues, appelez GetLastError.

Remarques

La fonction RemoveDirectory2 marque un répertoire à supprimer à la fermeture. Par conséquent, le répertoire n’est pas supprimé tant que le dernier handle du répertoire n’est pas fermé.

Pour supprimer de manière récursive les fichiers d’un répertoire, utilisez la fonction SHFileOperation .

RemoveDirectory2 peut être utilisé pour supprimer une jonction de répertoire. Étant donné que le répertoire cible et son contenu restent accessibles via son chemin canonique, le répertoire cible lui-même n’est pas affecté par la suppression d’une jonction qui la cible. Pour cette raison, lorsque lpPathName fait référence à une jonction de répertoire, RemoveDirectory2 supprime le lien spécifié, que le répertoire cible soit vide ou non. Pour plus d’informations sur les jonctions, consultez Liens durs et jonctions.

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

Cette fonction est prise en charge par les technologies suivantes :

Spécifications

Voir aussi

CreateDirectory2

Création et suppression de répertoires

Fonctions de gestion de l'annuaire

RemoveDirectoryTransacted