Freigeben über


CreateDirectoryFromAppW-Funktion (fileapifromapp.h)

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

Syntax

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

Die Parameter

lpPathName

Der Pfad des zu erstellenden Verzeichnisses.

Weitere Informationen zum Deaktivieren der MAX_PATH Einschränkung ohne voranstehende "\\?\", finden Sie im Abschnitt "Maximale Pfadlängenbeschränkung" der Benennungsdateien, Pfade und Namespaces .

lpSecurityAttributes

Ein Zeiger auf eine SECURITY_ATTRIBUTES Struktur. Das lpSecurityDescriptor-Element der Struktur gibt einen Sicherheitsdeskriptor für das neue Verzeichnis an. Wenn lpSecurityAttributesNULL ist, erhält das Verzeichnis einen Standardsicherheitsdeskriptor. Die ACLs im Standardsicherheitsdeskriptor für ein Verzeichnis werden vom übergeordneten Verzeichnis geerbt.

Das Zieldateisystem muss die Sicherheit für Dateien und Verzeichnisse unterstützen, damit dieser Parameter wirksam wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen. Mögliche Fehler sind:

Rückgabecode Description
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

Anforderung Wert
Mindestens unterstützter Client Windows 10, Version 1803
Header fileapifromapp.h
Library OneCore.Lib