Función GetFileTitleA (commdlg.h)

Recupera el nombre del archivo especificado.

Sintaxis

short GetFileTitleA(
  [in]  LPCSTR unnamedParam1,
  [out] LPSTR  Buf,
  [in]  WORD   cchSize
);

Parámetros

[in] unnamedParam1

Tipo: LPCTSTR de

Nombre y ubicación de un archivo.

[out] Buf

Tipo: LPTSTR de

Búfer que recibe el nombre del archivo.

[in] cchSize

Tipo: word

Longitud, en caracteres, del búfer al que apunta el parámetro lpszTitle.

Valor devuelto

Tipo: corto

Si la función se ejecuta correctamente, el valor devuelto es cero.

Si el nombre de archivo no es válido, se desconoce el valor devuelto. Si se produce un error, el valor devuelto es un número negativo.

Si el búfer al que apunta el parámetro lpszTitle es demasiado pequeño, el valor devuelto es un entero positivo que especifica el tamaño de búfer necesario, en caracteres. El tamaño de búfer necesario incluye el carácter NULO de terminación.

Observaciones

GetFileTitle solo debe llamarse con nombres de archivo legales; el uso de un nombre de archivo no válido tiene un resultado indefinido.

Para obtener el tamaño del búfer necesario para el nombre de un archivo, llame a la función con lpszTitle establecido en NULL y cchSize establecido en cero. La función devuelve el tamaño necesario.

getFileTitle devuelve la cadena que el sistema usaría para mostrar el nombre de archivo al usuario. El nombre para mostrar solo incluye una extensión si es la preferencia del usuario para mostrar nombres de archivo. Esto significa que la cadena devuelta puede no identificar con precisión el archivo si se usa en llamadas a funciones del sistema de archivos.

Si el búfer de lpszTitle es demasiado pequeño, GetFileTitle devuelve el tamaño necesario para contener el nombre para mostrar. Sin embargo, no hay ninguna relación garantizada entre el tamaño necesario y los caracteres especificados originalmente en el búfer de lpszFile. Por ejemplo, no llame a getFileTitle con lpszTitle establecido en null y cchSize establecido en cero y, a continuación, intente usar el valor devuelto como índice en la cadena lpszFile. Normalmente, puede lograr resultados similares (y un rendimiento superior) con funciones de biblioteca en tiempo de ejecución de C, como strrchr, wcsrchry _mbsrchr.

Nota

El encabezado commdlg.h define GetFileTitle como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	commdlg.h (incluya Windows.h)
biblioteca de	Comdlg32.lib
DLL de	Comdlg32.dll
conjunto de API de	ext-ms-win-shell-comdlg32-l1-1-1 (introducido en Windows 10, versión 10.0.14393)

Consulte también

biblioteca de cuadros de diálogo común de

conceptual de

GetOpenFileName

GetSaveFileName

de referencia de