Fonction SHGetSpecialFolderLocation (shlobj_core.h)

Article
03/02/2024

[SHGetSpecialFolderLocation n’est pas pris en charge et peut être modifié ou indisponible à l’avenir. Utilisez plutôt SHGetFolderLocation.]

Récupère un pointeur vers la structure ITEMIDLIST d’un dossier spécial.

Syntaxe

HRESULT SHGetSpecialFolderLocation(
  [in]  HWND             hwnd,
  [in]  int              csidl,
  [out] PIDLIST_ABSOLUTE *ppidl
);

Paramètres

[in] hwnd

Type : HWND

Réservé.

[in] csidl

Type : int

Valeur CSIDL qui identifie le dossier d’intérêt.

[out] ppidl

Type : PIDLIST_ABSOLUTE*

PIDL spécifiant l’emplacement du dossier par rapport à la racine de l’espace de noms (le bureau). Il incombe à l’application appelante de libérer l’IDList retourné à l’aide de CoTaskMemFree.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 4.0 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-1 (introduit dans Windows 10, version 10.0.10240)

Voir aussi

SHGetSpecialFolderPath

Partager via