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 transactionnelle, utilisez la fonction CreateDirectoryTransacted.
Syntaxe
BOOL CreateDirectory(
[in] LPCTSTR lpPathName,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
Paramètres
[in] lpPathName
Chemin d’accès 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 d’accès de 248 caractères (MAX_PATH - suffisamment de place 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 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 |
|---|---|
|
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 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.
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 | winbase.h (inclure Windows.h) |
| bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |
Voir aussi
création et suppression de répertoires