Função GetSaveFileNameA (commdlg.h)

[A partir do Windows Vista, as caixas de diálogo comuns Abrir e Salvar como foram substituídas pelode Diálogo de Item Comum . Recomendamos que você use a API de Diálogo de Item Comum em vez dessas caixas de diálogo da Biblioteca de Caixas de Diálogo Comuns.]

Cria uma caixa de diálogo Salvar que permite que o usuário especifique a unidade, o diretório e o nome de um arquivo a ser salvo.

Sintaxe

BOOL GetSaveFileNameA(
  [in, out] LPOPENFILENAMEA unnamedParam1
);

Parâmetros

[in, out] unnamedParam1

Tipo: LPOPENFILENAME

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

Valor de retorno

Tipo: BOOL

Se o usuário especificar um nome de arquivo e clicar no botão OK e a função for bem-sucedida, o valor retornado não será zero. O buffer apontado pelo lpstrFile membro da estrutura OPENFILENAME contém o caminho completo e o nome do arquivo especificados pelo usuário.

Se o usuário cancelar ou fechar o caixa de diálogo Salvar ou ocorrer um erro como o buffer de nome de arquivo muito pequeno, o valor retornado será zero. Para obter informações de erro estendidas, chame a função CommDlgExtendedError, que pode retornar um dos seguintes valores:

Observações

A caixa de diálogo Salvar no estilo Explorer que fornece recursos de interface do usuário semelhantes ao Windows Explorer. Você pode fornecer um procedimento de gancho OFNHookProc para uma caixa de diálogo Salvar no estilo Explorer. Para habilitar o procedimento de gancho, defina os sinalizadores OFN_EXPLORER e OFN_ENABLEHOOK no Flags membro da estrutura OPENFILENAME e especifique o endereço do procedimento de gancho no membro lpfnHook do .

O Windows continua a oferecer suporte ao estilo antigo caixas de diálogo Salvar para aplicativos que desejam manter uma interface do usuário consistente com a interface do usuário de estilo antigo. Para exibir a caixa de diálogo Salvar à moda antiga, habilite um procedimento de gancho OFNHookProcOldStyle e verifique se o sinalizador de OFN_EXPLORER não está definido.

Exemplos

Para obter um exemplo, consulte Criando umde metafile aprimorado.

Nota

O cabeçalho commdlg.h define GetSaveFileName como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	commdlg.h (inclua Windows.h)
biblioteca	Comdlg32.lib
de DLL	Comdlg32.dll
conjunto de API	ext-ms-win-shell-comdlg32-l1-1-1 (introduzido no Windows 10, versão 10.0.14393)

Consulte também

CommDlgExtendedError

da Biblioteca de Caixas de Diálogo Comuns

Conceitual

GetOpenFileName

OFNHookProc

OFNHookProcOldStyle

OPENFILENAME

de referência de