CreateDirectoryA, fonction (fileapi.h)

Article
11/20/2024

Crée un répertoire. Si le système de fichiers sous-jacent prend en charge la sécurité sur les fichiers et les répertoires, la fonction applique un descripteur de sécurité spécifié au nouveau répertoire.

Pour spécifier un répertoire de modèle, utilisez la fonction CreateDirectoryEx.

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

Syntaxe

BOOL CreateDirectoryA(
  [in]           LPCSTR                lpPathName,
  [in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Paramètres

[in] lpPathName

Chemin d’accès du répertoire à créer.

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 d’accès et des espaces de noms.

Pourboire

À compter de Windows 10, version 1607, vous pouvez choisir de supprimer la limitation MAX_PATH sans précéder « \\ ?\ ». Pour plus d’informations, consultez la section « Limite maximale de longueur de chemin » de noms, fichiers, chemin s et espaces de noms.

[in, optional] lpSecurityAttributes

Pointeur vers une structure SECURITY_ATTRIBUTES. Le lpSecurityDescriptor membre de la structure spécifie un descripteur de sécurité pour le nouveau répertoire. Si lpSecurityAttributes est NULL, le répertoire obtient un descripteur de sécurité par défaut. Les listes de contrôle d’accès dans le descripteur de sécurité par défaut d’un répertoire sont héritées de son répertoire parent.

Le système de fichiers cible doit prendre en charge la sécurité sur les fichiers et les répertoires pour que ce paramètre ait un effet. (Cela est indiqué lorsque GetVolumeInformation retourne FS_PERSISTENT_ACLS.)

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. Les erreurs possibles sont les suivantes.

Retourner le code	Description
ERROR_ALREADY_EXISTS	Le répertoire spécifié existe déjà.
ERROR_PATH_NOT_FOUND	Un ou plusieurs répertoires intermédiaires n’existent pas ; cette fonction crée uniquement le répertoire final dans le chemin d’accès.

Remarques

Certains systèmes de fichiers, tels que le système de fichiers NTFS, prennent en charge la compression ou le chiffrement des fichiers et répertoires individuels. Sur les volumes mis en forme pour un tel système de fichiers, un nouveau répertoire hérite des attributs de compression et de chiffrement de son répertoire parent.

Une application peut obtenir un handle dans un répertoire en appelant createFile avec l’indicateur de FILE_FLAG_BACKUP_SEMANTICS défini. Pour obtenir un exemple de code, consultez CreateFile.

Pour prendre en charge les fonctions d’héritage qui interrogent le descripteur de sécurité de cet objet peuvent heuristiquement déterminer et signaler que l’héritage est en vigueur. Pour plus d’informations, consultez propagation automatique des AE héritantes.

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

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

Exemples

Pour obtenir un exemple, consultez récupération et modification des attributs de fichier.

Note

L’en-tête fileapi.h définit CreateDirectory comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	fileapi.h (include Windows.h)
bibliothèque	Kernel32.lib
DLL	Kernel32.dll