O GetSaveFileName função cria uma Salvar caixa de diálogo comum que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo para salvar.
(BOOL GetSaveFileName LPOPENFILENAME lpofn / / endereço da estrutura com inicialização / / dados);
Se o usuário especifica um nome de arquivo e clica no botão OK , o valor de retorno é diferente de zero. A reserva apontada pelo lpstrFile membro das OPENFILENAME estrutura contém os caminho completo e nome do arquivo especificado pelo usuário.
Se o usuário cancela ou fecha a caixa de diálogo Salvar ou ocorre um erro, o valor de retorno é zero. Para obter informações de erro estendidas, chamar o CommDlgExtendedError função, que pode retornar uma dos seguinte valores:
| CDERR_FINDRESFAILURE | CDERR_NOHINSTANCE |
| CDERR_INITIALIZATION | CDERR_NOHOOK |
| CDERR_LOCKRESFAILURE | CDERR_NOTEMPLATE |
| CDERR_LOADRESFAILURE | CDERR_STRUCTSIZE |
| CDERR_LOADSTRFAILURE | FNERR_BUFFERTOOSMALL |
| CDERR_MEMALLOCFAILURE | FNERR_INVALIDFILENAME |
| CDERR_MEMLOCKFAILURE | FNERR_SUBCLASSFAILURE |
Por padrão, o Windows 95 e Windows NT versão 4.0 exibem uma nova versão da caixa de diálogo Salvar que fornece recursos de interface do usuário semelhantes do Windows Explorer. Você pode fornecer um procedimento de gancho de OFNHookProc para uma caixa de diálogo estilo do Explorer Salvar . Para habilitar o procedimento gancho, definir os sinalizadores OFN_EXPLORER e OFN_ENABLEHOOK in o sinalizadores membro das OPENFILENAME estrutura e especificar o endereço do procedimento de gancho na lpfnHook membro.
Windows 95 e Windows NT 4.0 continuam a apoiar a antiga caixa de diálogo Salvar para aplicativos que deseja manter uma interface de usuário compatível com o Windows 3.1 ou Windows NT 3.51-interface do usuário. Para exibir a antiga caixa de diálogo Salvar , habilitar um procedimento de gancho de OFNHookProcOldStyle e verifique se o Sinalizar OFN_EXPLORER não está definido.
Windows CE: Nem todos os membros das OPENFILENAME estrutura são definidos em Windows CE. Para obter informações sobre os membros definidos, consulte o tópico de referência para a estrutura OPENFILENAME .
nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declaradas no commdlg.h.
Biblioteca de importação:Use comdlg32.lib.
Unicode:Implementado como versões Unicode e ANSI no Windows NT.
Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME