Función GetSaveFileNameA (commdlg.h)
[A partir de Windows Vista, los cuadros de diálogo comunes Abrir y guardar como común se han reemplazado por el cuadro de diálogo elemento común. Se recomienda usar Common Item Dialog API en lugar de estos cuadros de diálogo de la biblioteca de cuadros de diálogo comunes.
Crea un cuadro de diálogo Guardar que permite al usuario especificar la unidad, el directorio y el nombre de un archivo que se va a guardar.
Sintaxis
BOOL GetSaveFileNameA(
[in, out] LPOPENFILENAMEA unnamedParam1
);
Parámetros
[in, out] unnamedParam1
Tipo: LPOPENFILENAME
Puntero a una estructura OPENFILENAME que contiene información utilizada para inicializar el cuadro de diálogo. Cuando se devuelve GetSaveFileName, esta estructura contiene información sobre la selección de archivos del usuario.
Valor devuelto
Tipo: BOOL de
Si el usuario especifica un nombre de archivo y hace clic en el botón Aceptar y la función se ejecuta correctamente, el valor devuelto es distinto de cero. El búfer al que apunta el lpstrFile miembro del OPENFILENAME estructura contiene la ruta de acceso completa y el nombre de archivo especificados por el usuario.
Si el usuario cancela o cierra el cuadro de diálogo Guardar o se produce un error como el búfer de nombres de archivo que es demasiado pequeño, el valor devuelto es cero. Para obtener información de error extendida, llame a la función
Observaciones
El cuadro de diálogo Guardar estilo explorador que proporciona características de interfaz de usuario similares al Explorador de Windows. Puede proporcionar un procedimiento de enlace de OFNHookProc para un cuadro de diálogo Guardar estilo explorador. Para habilitar el procedimiento de enlace, establezca las marcas OFN_EXPLORER y OFN_ENABLEHOOK en el miembro Flags del miembro OPENFILENAME y especifique la dirección del procedimiento de enlace en el miembro lpfnHook.
Windows sigue admitiendo cuadros de diálogo Guardar estilo antiguo para las aplicaciones que quieran mantener una interfaz de usuario coherente con la interfaz de usuario de estilo anterior. Para mostrar el cuadro de diálogo Guardar de estilo antiguo, habilite un procedimiento de enlace de OFNHookProcOldStyle y asegúrese de que la marca OFN_EXPLORER no esté establecida.
Ejemplos
Para obtener un ejemplo, vea Creación de un metarchivo mejorado.
Nota
El encabezado commdlg.h define GetSaveFileName 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
de referencia de