Método IFileDialog::GetFileName (shobjidl_core.h)

Recupera o texto inserido atualmente na caixa de edição Nome do arquivo da caixa de diálogo.

Sintaxe

HRESULT GetFileName(
  [out] LPWSTR *pszName
);

Parâmetros

[out] pszName

Tipo: WCHAR**

O endereço de um ponteiro para um buffer que, quando esse método retorna com êxito, recebe o texto.

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

O texto na caixa de edição Nome do arquivo não reflete necessariamente o item escolhido pelo usuário. Para obter o item escolhido pelo usuário, use IFileDialog::GetResult.

O aplicativo de chamada é responsável por liberar o buffer recuperado usando a função CoTaskMemFree .

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)