SHCreateDirectory-Funktion (shlobj_core.h)

  • Artikel

[SHCreateDirectory ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Erstellt einen neuen Dateisystemordner.

Syntax

int SHCreateDirectory(
  [in, optional] HWND   hwnd,
  [in]           PCWSTR pszPath
);

Parameter

[in, optional] hwnd

Typ: HWND

Ein Handle für ein übergeordnetes Fenster. Dieser Parameter kann auf NULL festgelegt werden, wenn keine Benutzeroberfläche angezeigt wird.

[in] pszPath

Typ: PCWSTR

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den vollqualifizierten Pfad des Verzeichnisses enthält. Diese Zeichenfolge sollte nicht mehr als MAX_PATH Zeichen enthalten, einschließlich des endenden NULL-Zeichens.

Rückgabewert

Typ: int

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS zurück. Wenn der Vorgang fehlschlägt, können andere Fehlercodes zurückgegeben werden, einschließlich der hier aufgeführten. Werte, die nicht speziell aufgeführt sind, finden Sie unter Systemfehlercodes.

Rückgabecode Beschreibung
ERROR_BAD_PATHNAME
 Der parameter pszPath wurde auf einen relativen Pfad festgelegt.
ERROR_FILENAME_EXCED_RANGE
 Der Pfad, auf den pszPath verweist, ist zu lang.
ERROR_FILE_EXISTS
 Das Verzeichnis ist vorhanden.
ERROR_ALREADY_EXISTS
 Das Verzeichnis ist vorhanden.
ERROR_CANCELLED
 Der Benutzer hat den Vorgang abgebrochen.

Hinweise

Diese Funktion erstellt einen Dateisystemordner, dessen vollqualifizierter Pfad von pszPath angegeben wird. Wenn mindestens einer der Zwischenordner nicht vorhanden ist, werden sie erstellt.

Verwenden Sie SHCreateDirectoryEx, um Sicherheitsattribute für einen neuen Ordner festzulegen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

SHCreateDirectoryEx