Compartir a través de

Función GetFileNameFromBrowse (shlobj.h)

  • Artículo

[Esta función está disponible a través de Windows XP Service Pack 2 (SP2) y Windows Server 2003. Puede modificarse o no estar disponible en versiones posteriores de Windows.

Crea un cuadro de diálogo Abrir para que el usuario pueda especificar la unidad, el directorio y el nombre de un archivo que se va a abrir.

Sintaxis

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

Tipo: HWND

Identificador de la ventana que posee el cuadro de diálogo. Este miembro puede ser cualquier identificador de ventana válido o puede ser NULL si el cuadro de diálogo no tiene propietario.

[in, out] pszFilePath

Tipo: PWSTR

Cadena Unicode terminada en null que contiene un nombre de archivo usado para inicializar el control de edición Nombre de archivo. Esta cadena corresponde al miembro lpstrFile de la estructura OPENFILENAME y se usa exactamente de la misma manera.

cchFilePath

Tipo: UINT

Número de caracteres de pszFilePath, incluido el carácter nulo de terminación.

[in, optional] pszWorkingDir

Tipo: PCWSTR

Ruta de acceso completa del archivo del directorio inicial. Esta cadena corresponde al miembro lpstrInitialDir de la estructura OPENFILENAME y se usa exactamente de la misma manera.

[in] pszDefExt

Tipo: PCWSTR

Cadena Unicode terminada en null que contiene la extensión de nombre de archivo predeterminada. Esta extensión se agrega a pszFilePath si el usuario no especifica una extensión. La cadena no debe contener ningún carácter '.'. Si esta cadena es NULL y el usuario no puede escribir una extensión, no se anexa ninguna extensión.

[in, optional] pszFilters

Tipo: PCWSTR

Cadena Unicode terminada en null que define el filtro. Esta cadena corresponde al miembro lpstrFilter de la estructura OPENFILENAME y se usa exactamente de la misma manera.

[in, optional] pszTitle

Tipo: PCWSTR

Cadena Unicode terminada en null que se coloca en la barra de título del cuadro de diálogo. Si este valor es NULL, el sistema usa el título predeterminado.

Valor devuelto

Tipo: BOOL

Si el usuario especifica un nombre de archivo y hace clic en Aceptar, el valor devuelto es TRUE. El búfer al que pszFilePath apunta contiene la ruta de acceso completa y el nombre de archivo que especifica el usuario. Si el usuario cancela o cierra el cuadro de diálogo Abrir o se produce un error, el valor devuelto es FALSE.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj.h (incluya Shlobj.h)
Library Shell32.lib
Archivo DLL Shell32.dll (versión 5.0 o posterior)

Consulte también

GetOpenFileName