Fonction SHGetSpecialFolderLocation (shlobj_core.h)

  • Article

[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