CreateDirectoryW-Funktion (fileapi.h)
Erstellt ein neues Verzeichnis. Wenn das zugrunde liegende Dateisystem Die Sicherheit für Dateien und Verzeichnisse unterstützt, wendet die Funktion einen angegebenen Sicherheitsdeskriptor auf das neue Verzeichnis an.
Verwenden Sie die CreateDirectoryEx-Funktion , um ein Vorlagenverzeichnis anzugeben.
Um diesen Vorgang als transaktionierten Vorgang auszuführen, verwenden Sie die CreateDirectoryTransacted-Funktion .
Syntax
BOOL CreateDirectoryW(
[in] LPCWSTR lpPathName,
[in, optional] LPSECURITY_ATTRIBUTES lpSecurityAttributes
);
Parameter
[in] lpPathName
Der Pfad des zu erstellenden Verzeichnisses.
Standardmäßig ist der Name auf MAX_PATH Zeichen beschränkt. Um diesen Grenzwert auf 32.767 Breitzeichen zu erweitern, stellen Sie dem Pfad "\\?\" voran. Weitere Informationen finden Sie unter Benennen von Dateien, Pfaden und Namespaces.
Tipp
Ab Windows 10 Version 1607 können Sie die MAX_PATH-Einschränkung aufheben, ohne "\\?\" vorab ausstehen zu müssen. Ausführliche Informationen finden Sie im Abschnitt "Maximale Längenbeschränkung für Pfade" unter Benennen von Dateien, Pfaden und Namespaces .
[in, optional] lpSecurityAttributes
Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur . Der lpSecurityDescriptor-Member der -Struktur gibt einen Sicherheitsdeskriptor für das neue Verzeichnis an. Wenn lpSecurityAttributesNULL ist, ruft das Verzeichnis einen Standardsicherheitsdeskriptor ab. Die ACLs im Standardsicherheitsdeskriptor für ein Verzeichnis werden vom übergeordneten Verzeichnis geerbt.
Das Zieldateisystem muss die Sicherheit von Dateien und Verzeichnissen unterstützen, damit dieser Parameter eine Auswirkung hat. (Dies wird angezeigt, wenn GetVolumeInformationFS_PERSISTENT_ACLS zurückgibt.)
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Mögliche Fehler sind:
Rückgabecode | Beschreibung |
---|---|
|
Das angegebene Verzeichnis ist bereits vorhanden. |
|
Mindestens ein Zwischenverzeichnis ist nicht vorhanden; Diese Funktion erstellt nur das endgültige Verzeichnis im Pfad. |
Bemerkungen
Einige Dateisysteme, z. B. das NTFS-Dateisystem, unterstützen die Komprimierung oder Verschlüsselung für einzelne Dateien und Verzeichnisse. Auf Volumes, die für ein solches Dateisystem formatiert sind, erbt ein neues Verzeichnis die Komprimierungs- und Verschlüsselungsattribute des übergeordneten Verzeichnisses.
Eine Anwendung kann ein Handle für ein Verzeichnis abrufen, indem CreateFile mit festgelegtem FILE_FLAG_BACKUP_SEMANTICS-Flag aufgerufen wird. Ein Codebeispiel finden Sie unter CreateFile.
Um Vererbungsfunktionen zu unterstützen, die den Sicherheitsdeskriptor dieses Objekts abfragen, kann heuristisch bestimmt und gemeldet werden, dass die Vererbung wirksam ist. Weitere Informationen finden Sie unter Automatische Weitergabe von vererbbaren ACEs .
In Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
Technologie | Unterstützt |
---|---|
Server Message Block (SMB) 3.0-Protokoll | Ja |
SMB 3.0 Transparent Failover (TFO) | Ja |
SMB 3.0 mit Dateifreigaben für horizontales Skalieren (SO) | Ja |
Freigegebenes Clustervolume-Dateisystem (CsvFS) | Ja |
Robustes Dateisystem (Resilient File System, ReFS) | Ja |
Beispiele
Ein Beispiel finden Sie unter Abrufen und Ändern von Dateiattributen.
Hinweis
Der Fileapi.h-Header definiert CreateDirectory als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
Zielplattform | Windows |
Kopfzeile | fileapi.h (Einschließen von Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
Erstellen und Löschen von Verzeichnissen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für