SHGetSpecialFolderPathA-Funktion (shlobj_core.h)

Artikel
03/02/2024

[SHGetSpecialFolderPath wird nicht unterstützt. Verwenden Sie stattdessen SHGetFolderPath.]

Ruft den Pfad eines speziellen Ordners ab, der durch seine CSIDL identifiziert wird.

Syntax

BOOL SHGetSpecialFolderPathA(
        HWND  hwnd,
  [out] LPSTR pszPath,
  [in]  int   csidl,
  [in]  BOOL  fCreate
);

Parameter

hwnd

Typ: HWND

Reserviert.

[out] pszPath

Typ: LPTSTR

Ein Zeiger auf eine NULL-Zeichenfolge, die das Laufwerk und den Pfad des angegebenen Ordners empfängt. Dieser Puffer muss mindestens MAX_PATH Zeichen groß sein.

[in] csidl

Typ: int

Eine CSIDL , die den ordner von Interesse identifiziert. Wenn ein virtueller Ordner angegeben wird, schlägt diese Funktion fehl.

[in] fCreate

Typ: BOOL

Gibt an, ob der Ordner erstellt werden soll, wenn er noch nicht vorhanden ist. Wenn dieser Wert nichtzero ist, wird der Ordner erstellt. Wenn dieser Wert 0 ist, wird der Ordner nicht erstellt.

Rückgabewert

Typ: BOOL

TRUE , wenn erfolgreich; andernfalls FALSE.

Hinweise

Das Microsoft Internet Explorer 4.0 Desktop Update muss installiert sein, damit diese Funktion verfügbar ist.

Hinweis

Der shlobj_core.h-Header definiert SHGetSpecialFolderPath als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h (einschließlich Shlobj.h, Shlobj_core.h)
Bibliothek	Shell32.lib
DLL	Shell32.dll (Version 4.71 oder höher)

Freigeben über