SHGetSpecialFolderPathA-Funktion (shlobj_core.h)

[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.

Anforderungen