CreateDirectory2W, fonction (fileapi.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

HANDLE CreateDirectory2W(
  LPCWSTR               lpPathName,
  DWORD                 dwDesiredAccess,
  DWORD                 dwShareMode,
  DIRECTORY_FLAGS       DirectoryFlags,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

Paramètres

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

dwDesiredAccess

Valeur ACCESS_MASK qui exprime le type d’accès requis par l’appelant au répertoire. L’ensemble d’indicateurs dwDesiredAccess définis par le système détermine les objets de fichier de fichiers de répertoire de droits d’accès spécifiques suivants :

dwShareMode

Type d’accès de partage que l’appelant souhaite utiliser dans le fichier, comme zéro, ou comme une ou une combinaison des valeurs suivantes :

DirectoryFlags

Ce paramètre peut contenir des combinaisons de DIRECTORY_FLAGS.

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 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 :

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 peuvent heuristiquement déterminer et signaler que l’héritage est en vigueur. Pour plus d’informations, consultez Propagation automatique des AE héritantes .

Cette fonction est prise en charge par les technologies suivantes :

Exemples

L’exemple suivant crée un répertoire avec la fonction CreateDirectory2 . Le nouveau répertoire est créé avec les droits d’accès FILE_LIST_DIRECTORY et SYNCHRONIZE . Le nouveau répertoire est également créé avec le mode de partage FILE_SHARE_READ , ce qui permet à d’autres processus d’ouvrir le répertoire pour l’accès en lecture.

// THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF 
// ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO 
// THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A 
// PARTICULAR PURPOSE. 
// 
// Copyright (C) Microsoft. All rights reserved 
#include <Windows.h>
#include <stdio.h>
#include <strsafe.h>

int main(int argc, wchar_t* argv[])
{
    WCHAR filePath[MAX_PATH] = { 0 };

    // Create a directory to put a file into, that can't be deleted
    // and redirected before this handle is closed.
    HANDLE hDirectory = CreateDirectory2(argv[1],
        FILE_LIST_DIRECTORY | SYNCHRONIZE,
        FILE_SHARE_READ,
        DIRECTORY_FLAGS_NONE,
        NULL,
        NULL);
    if (hDirectory == INVALID_HANDLE_VALUE)
    {
        // Handle the error.
        printf("CreateDirectory2 failed (%d)\n", GetLastError());
        return (1);
    }

    StringCchPrintf(filePath,
        ARRAYSIZE(filePath),
        L"%ws\\example.test",
        argv[1]);

    HANDLE hFile = CreateFile3(filePath,
        GENERIC_ALL,
        FILE_SHARE_READ,
        CREATE_ALWAYS,
        NULL);
    if (hFile == INVALID_HANDLE_VALUE)
    {
        // Handle the error.
        CloseHandle(hDirectory);
        printf("CreateFile3 failed (%d)\n", GetLastError());
        return (1);
    }

    CloseHandle(hFile);
    CloseHandle(hDirectory);
    return (0);
}

Pour obtenir des exemples supplémentaires, consultez Récupération et modification des attributs de fichier.

Spécifications

Voir aussi

CreateFile3

DeleteFile2

RemoveDirectory2