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.

Valor de retorno

Tipo: HRESULT

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

Observações

É 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.

Requirements