SHCreateDirectoryExA-Funktion (shlobj_core.h)
[Diese Funktion ist über Windows XP Service Pack 2 (SP2) und Windows Server 2003 verfügbar. In nachfolgenden Windows-Versionen ist sie möglicherweise geändert oder nicht verfügbar.]
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 NULL-Zeichenfolge, die den vollqualifizierten Pfad des Verzeichnisses angibt. Diese Zeichenfolge hat eine maximale Länge von 248 Zeichen, einschließlich des endenden 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. 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 System kann den Pfad, auf den pszPath verweist, nicht finden. Der Pfad kann einen ungültigen Eintrag enthalten. |
|
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 ebenfalls erstellt. SHCreateDirectoryEx überprüft auch, ob die Dateien sichtbar sind. Wenn sie nicht sichtbar sind, erwarten Sie folgendes:
- Wenn hwnd auf ein gültiges Fensterhandle festgelegt ist, wird ein Meldungsfeld angezeigt, in dem der Benutzer darauf hinweist, dass er möglicherweise nicht auf die Dateien zugreifen kann. Wenn der Benutzer sich dafür entscheidet, nicht fortzufahren, 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 nicht codierungsneutralem Code 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) |