Función SHGetNameFromIDList (shobjidl_core.h)

Recupera el nombre para mostrar de un elemento identificado por su IDList.

Syntax

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

Parámetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

PiDL que identifica el elemento.

[in] sigdnName

Tipo: SIGDN

Valor de la enumeración SIGDN que especifica el tipo de nombre para mostrar que se va a recuperar.

[out] ppszName

Tipo: PWSTR*

Valor que, cuando esta función vuelve correctamente, recibe la dirección de un puntero al nombre para mostrar recuperado.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Observaciones

Es responsabilidad del autor de la llamada liberar la cadena a la que apunta ppszName cuando ya no es necesaria. Llame a CoTaskMemFree en *ppszName para liberar la memoria.

Requisitos