Fonction SHGetNameFromIDList (shobjidl_core.h)

Récupère le nom d’affichage d’un élément identifié par son IDList.

Syntaxe

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

Paramètres

[in] pidl

Type : PCIDLIST_ABSOLUTE

PiDL qui identifie l’élément.

[in] sigdnName

Type : SIGDN

Valeur de l’énumération SIGDN qui spécifie le type de nom d’affichage à récupérer.

[out] ppszName

Type : PWSTR*

Valeur qui, lorsque cette fonction retourne correctement, reçoit l’adresse d’un pointeur vers le nom d’affichage récupéré.

Valeur retournée

Type : HRESULT

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

Remarques

Il incombe à l’appelant de libérer la chaîne pointée par ppszName lorsqu’elle n’est plus nécessaire. Appelez CoTaskMemFree sur *ppszName pour libérer la mémoire.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)
DLL	Shell32.dll