SHCreateDirectoryExW-Funktion (shlobj_core.h)

  • Artikel

[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar.]

Erstellt einen neuen Dateisystemordner mit optionalen Sicherheitsattributen.

Syntax

int SHCreateDirectoryExW(
  [in, optional] HWND                      hwnd,
  [in]           LPCWSTR                   pszPath,
  [in, optional] const SECURITY_ATTRIBUTES *psa
);

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: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den vollqualifizierten Pfad des Verzeichnisses angibt. Diese Zeichenfolge hat eine maximale Länge von 248 Zeichen, einschließlich des abschließenden NULL-Zeichens.

[in, optional] psa

Typ: const SECURITY_ATTRIBUTES*

Ein Zeiger auf eine SECURITY_ATTRIBUTES-Struktur mit dem Sicherheitsattribute des Verzeichnisses. Legen Sie diesen Parameter auf NULL fest, wenn keine Sicherheitsattribute festgelegt werden müssen.

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. Informationen zu Werten, die nicht speziell aufgeführt sind, finden Sie unter Systemfehlercodes.

Rückgabecode Beschreibung
ERROR_BAD_PATHNAME
 Der pszPath-Parameter wurde auf einen relativen Pfad festgelegt.
ERROR_FILENAME_EXCED_RANGE
 Der Pfad, auf den pszPath verweist, ist zu lang.
ERROR_PATH_NOT_FOUND
 Das System kann den Pfad, auf den pszPath verweist, nicht finden. Der Pfad kann einen ungültigen Eintrag enthalten.
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 ebenfalls erstellt. SHCreateDirectoryEx überprüft auch, ob die Dateien sichtbar sind. Wenn sie nicht sichtbar sind, erwarten Sie eine der folgenden Aktionen:

  • Wenn hwnd auf ein gültiges Fensterhandle festgelegt ist, wird ein Meldungsfeld angezeigt, das den Benutzer darauf hinweist, dass er möglicherweise nicht auf die Dateien zugreifen kann. Wenn der Benutzer den Vorgang nicht fortsetzen möchte, gibt die Funktion ERROR_CANCELLED zurück.
  • Wenn hwnd auf NULL festgelegt ist, wird keine Benutzeroberfläche angezeigt, und die Funktion gibt ERROR_CANCELLED zurück.

Hinweis

Der shlobj_core.h-Header definiert SHCreateDirectoryEx als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, 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, Shlobj_core.h)
Bibliothek Shell32.lib
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

SHCreateDirectory