Função SHGetNameFromIDList (shobjidl_core.h)

Recupera o nome de exibição de um item identificado por sua IDList.

Sintaxe

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

Parâmetros

[in] pidl

Tipo: PCIDLIST_ABSOLUTE

Um PIDL que identifica o item.

[in] sigdnName

Tipo: SIGDN

Um valor da enumeração SIGDN que especifica o tipo de nome de exibição a ser recuperado.

[out] ppszName

Tipo: PWSTR*

Um valor que, quando essa função retorna com êxito, recebe o endereço de um ponteiro para o nome de exibição recuperado.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

É responsabilidade do chamador liberar a cadeia de caracteres apontada por ppszName quando ela não for mais necessária. Chame CoTaskMemFree em *ppszName para liberar a memória.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shobjidl_core.h (inclua Shobjidl.h)
DLL	Shell32.dll