Freigeben über

CreateDirectoryFromAppW-Funktion (fileapifromapp.h)

  • Artikel

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