CreateDirectory, fonction (winbase.h)
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 traitée, utilisez la fonction CreateDirectoryTransacted .
Syntaxe
BOOL CreateDirectory(
[in] LPCTSTR lpPathName,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
Paramètres
[in] lpPathName
Chemin du répertoire à créer.
Pour la version ANSI de cette fonction, il existe une limite de taille de chaîne par défaut pour les chemins de 248 caractères (MAX_PATH - suffisamment d’espace pour un nom de fichier 8.3). Pour étendre cette limite à 32 767 caractères larges, appelez la version Unicode de la fonction et ajoutez « \ ? » au chemin d’accès. Pour plus d’informations, consultez Nommage d’un fichier
[in, optional] lpSecurityAttributes
Pointeur vers une structure SECURITY_ATTRIBUTES . Le membre lpSecurityDescriptor de la structure spécifie un descripteur de sécurité pour le nouveau répertoire. Si lpSecurityAttributes a la valeur 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 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. Les erreurs possibles sont les suivantes.
Code de retour | Description |
---|---|
|
Le répertoire spécifié existe déjà. |
|
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 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 peut déterminer de manière heuristique et signaler que l’héritage est en vigueur. Pour plus d’informations, consultez Propagation automatique des AE hérités .
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
Technologie | Prise en charge |
---|---|
Protocole Server Message Block (SMB) 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 |
Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
Système de fichiers résilient (ReFS) | Oui |
Exemples
Pour obtenir un exemple, consultez Récupération et modification d’attributs de fichier.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
Plateforme cible | Windows |
En-tête | winbase.h (inclure Windows.h) |
Bibliothèque | Kernel32.lib |
DLL | Kernel32.dll |
Voir aussi
Création et suppression de répertoires
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour