Funzione GetOpenFileNameA (commdlg.h)

Articolo
08/22/2023

[A partire da Windows Vista, le finestre di dialogo Apri e Salva con nome comune sono state sostituite dalla finestra di dialogo Elemento comune. È consigliabile usare l'API Finestra di dialogo elementi comuni anziché queste finestre di dialogo dalla libreria della finestra di dialogo comune.

Crea una finestra di dialogo Salva che consente all'utente di specificare l'unità, la directory e il nome di un file da salvare.

Sintassi

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

Parametri

[in, out] unnamedParam1

Tipo: LPOPENFILENAME

Puntatore a una struttura OPENFILENAME che contiene informazioni usate per inizializzare la finestra di dialogo. Quando GetSaveFileName restituisce, questa struttura contiene informazioni sulla selezione del file dell'utente.

Valore restituito

Tipo: BOOL

Se l'utente specifica un nome file e fa clic sul pulsante OK e la funzione ha esito positivo, il valore restituito è diverso da zero. Il buffer a cui fa riferimento il membro lpstrFile della struttura OPENFILENAME contiene il percorso completo e il nome di file specificati dall'utente.

Se l'utente annulla o chiude la finestra di dialogo Salva o un errore, ad esempio il buffer del nome file troppo piccolo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione CommDlgExtendedError , che può restituire uno dei valori seguenti:

Commenti

Finestra di dialogo Salva in stile Esplora risorse che fornisce funzionalità dell'interfaccia utente simili a Esplora risorse. È possibile fornire una procedura di hook OFNHookProc per una finestra di dialogo Salva in stile Explorer. Per abilitare la procedura di hook, impostare i flag di OFN_EXPLORER e OFN_ENABLEHOOK nel membro Flag della struttura OPENFILENAME e specificare l'indirizzo della routine hook nel membro lpfnHook .

Windows continua a supportare le finestre di dialogo Salva in stile precedente per le applicazioni che vogliono mantenere un'interfaccia utente coerente con l'interfaccia utente precedente. Per visualizzare la finestra di dialogo Salva in stile precedente, abilitare una procedura di hook OFNHookProcOldStyle e assicurarsi che il flag di OFN_EXPLORER non sia impostato.

Esempio

Per un esempio, vedere Creazione di un metafile avanzato.

Nota

L'intestazione commdlg.h definisce GetSaveFileName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	commdlg.h (includere Windows.h)
Libreria	Comdlg32.lib
DLL	Comdlg32.dll
Set di API	ext-ms-win-shell-comdlg32-l1-1-1 (introdotta in Windows 10, versione 10.0.14393)