SHCreateDirectoryExA-Funktion (shlobj_core.h)

Artikel
11/20/2024

[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. Sie kann in nachfolgenden Versionen von Windows geändert oder nicht verfügbar sein.]

Erstellt einen neuen Dateisystemordner mit optionalen Sicherheitsattributen.

Syntax

int SHCreateDirectoryExA(
  [in, optional] HWND                      hwnd,
  [in]           LPCSTR                    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 mit Null beendete Zeichenfolge, die den vollqualifizierten Pfad des Verzeichnisses angibt. Diese Zeichenfolge beträgt maximal 248 Zeichen, einschließlich des endenden NULL-Zeichens.

[in, optional] psa

Typ: 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 ERROR_SUCCESS zurück, wenn dies erfolgreich ist. Wenn der Vorgang fehlschlägt, können andere Fehlercodes zurückgegeben werden, einschließlich der hier aufgeführten Fehlercodes. Werte, die nicht ausdrücklich 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 nicht finden, auf den pszPathverweist. 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.

Bemerkungen

Diese Funktion erstellt einen Dateisystemordner, dessen vollqualifizierter Pfad von pszPathangegeben wird. Wenn mindestens ein 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 Optionen:

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

Anmerkung

Der header shlobj_core.h 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
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Library	Shell32.lib
DLL-	Shell32.dll (Version 5.0 oder höher)

Siehe auch

SHCreateDirectory-

Freigeben über