SHGetNameFromIDList, fonction (shobjidl_core.h)

Récupère le nom complet 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 complet à récupérer.

[out] ppszName

Type : PWSTR*

Valeur qui, lorsque cette fonction retourne correctement, reçoit l’adresse d’un pointeur vers le nom complet 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’il n’est plus nécessaire. Appelez CoTaskMemFree sur *ppszName pour libérer la mémoire.

Spécifications