Compartir a través de

Función SHGetNameFromIDList (shobjidl_core.h)

  • Artículo

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

Sintaxis

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 devuelve correctamente, recibe la dirección de un puntero al nombre para mostrar recuperado.

Valor devuelto

Tipo: HRESULT

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

Comentarios

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

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (incluya Shobjidl.h)
Archivo DLL Shell32.dll