SHCreateDirectory-Funktion (shlobj_core.h)
[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 |
|---|---|
|
Der parameter pszPath wurde auf einen relativen Pfad festgelegt. |
|
Der Pfad, auf den pszPath verweist, ist zu lang. |
|
Das Verzeichnis ist vorhanden. |
|
Das Verzeichnis ist vorhanden. |
|
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) |