Compartilhar via


Método IShellItem::GetDisplayName (shobjidl_core.h)

Obtém o nome de exibição do objeto IShellItem .

Sintaxe

HRESULT GetDisplayName(
  [in]  SIGDN  sigdnName,
  [out] LPWSTR *ppszName
);

Parâmetros

[in] sigdnName

Tipo: SIGDN

Um dos valores SIGDN que indica a aparência do nome.

[out] ppszName

Tipo: LPWSTR*

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 o método for bem-sucedido, ele 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 XP com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shlguid.h)
DLL Shell32.dll (versão 5.00 ou posterior)

Confira também

Ishellfolder

Ishellitem