SHGetSpecialFolderPathW-Funktion (shlobj_core.h)

Artikel
03/04/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 SHGetSpecialFolderPathW(
        HWND   hwnd,
  [out] LPWSTR pszPath,
  [in]  int    csidl,
  [in]  BOOL   fCreate
);

Parameter

hwnd

Typ: HWND

Reserviert.

[out] pszPath

Typ: LPTSTR

Ein Zeiger auf eine NULL-endende 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 relevanten Ordner 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 ungleich null 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 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 [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)

Share via