GetSaveFileName

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);
 

Parâmetros

lpofn
Ponteiro para um OPENFILENAME estrutura que contém informações usadas para inicializar a caixa de diálogo. Quando GetSaveFileName retorna, essa estrutura contém informações sobre arquivo seleção do usuário.

Retornar valores

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

Observações

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 .

QuickInfo

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.

Ver também

Visão geral de biblioteca de caixa de diálogo comum, funções de caixa de diálogo comuns, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index