Função GetFileNameFromBrowse (shlobj.h)

[Essa função está disponível por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Ele pode estar alterado ou indisponível em versões subsequentes do Windows.]

Cria uma caixa de diálogo Abrir para que o usuário possa especificar a unidade, o diretório e o nome de um arquivo a ser aberto.

Sintaxe

BOOL GetFileNameFromBrowse(
  [in, optional] HWND   hwnd,
  [in, out]      PWSTR  pszFilePath,
                 UINT   cchFilePath,
  [in, optional] PCWSTR pszWorkingDir,
  [in]           PCWSTR pszDefExt,
  [in, optional] PCWSTR pszFilters,
  [in, optional] PCWSTR pszTitle
);

Parâmetros

[in, optional] hwnd

Digite: HWND

Um identificador para a janela que possui a caixa de diálogo. Esse membro pode ser qualquer identificador de janela válido ou nulo se a caixa de diálogo não tiver proprietário.

[in, out] pszFilePath

Tipo: PWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém um nome de arquivo usado para inicializar o controle de edição nome de arquivo. Essa cadeia de caracteres corresponde ao membro lpstrFile da estrutura OPENFILENAME e é usada exatamente da mesma maneira.

cchFilePath

Tipo: UINT

O número de caracteres em pszFilePath, incluindo o caractere nulo de terminação.

[in, optional] pszWorkingDir

Tipo: PCWSTR

O caminho de arquivo totalmente qualificado do diretório inicial. Essa cadeia de caracteres corresponde ao membro lpstrInitialDir da estrutura OPENFILENAME e é usada exatamente da mesma maneira.

[in] pszDefExt

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que contém a extensão de nome de arquivo padrão. Essa extensão será adicionada ao pszFilePath se o usuário não especificar uma extensão. A cadeia de caracteres não deve conter nenhum caractere '.'. Se essa cadeia de caracteres for NULL e o usuário não digitar uma extensão, nenhuma extensão será acrescentada.

[in, optional] pszFilters

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que define o filtro. Essa cadeia de caracteres corresponde ao membro lpstrFilter da estrutura OPENFILENAME e é usada exatamente da mesma maneira.

[in, optional] pszTitle

Tipo: PCWSTR

Uma cadeia de caracteres Unicode terminada em nulo que é colocada na barra de título da caixa de diálogo. Se esse valor for NULL, o sistema usará o título padrão.

Retornar valor

Tipo: BOOL

Se o usuário especificar um nome de arquivo e clicar em OK, o valor retornado será TRUE. O buffer para o qual pszFilePath aponta contém o caminho completo e o nome de arquivo que o usuário especifica. Se o usuário cancelar ou fechar a caixa de diálogo Abrir ou ocorrer um erro, o valor retornado será FALSE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlobj.h (inclua Shlobj.h)
Biblioteca	Shell32.lib
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

Getopenfilename