CreateDirectoryFromAppW-Funktion (fileapifromapp.h)

Erstellt ein neues Verzeichnis. Das Verhalten dieser Funktion ist mit CreateDirectory identisch, mit der Ausnahme, dass diese Funktion dem Universelle Windows-Plattform App-Sicherheitsmodell entspricht.

Syntax

WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
  LPCWSTR               lpPathName,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;

Parameter

lpPathName

Der Pfad des zu erstellenden Verzeichnisses.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne voranschreiten von "\\?\", finden Sie im Abschnitt "Beschränkung der maximalen Pfadlänge" unter Benennen von Dateien, Pfaden und Namespaces .

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.

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
ERROR_ALREADY_EXISTS	Das angegebene Verzeichnis ist bereits vorhanden.
ERROR_PATH_NOT_FOUND	Mindestens ein Zwischenverzeichnis ist nicht vorhanden; Diese Funktion erstellt nur das endgültige Verzeichnis im Pfad.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 10, Version 1803
Kopfzeile	fileapifromapp.h