La funzione GetSaveFileName crea una salvare dialogo comune che consente all'utente di specificare l'unità, directory e il nome di un file da salvare.
(BOOL GetSaveFileName LPOPENFILENAME lpofn / / indirizzo della struttura con l'inizializzazione / / dati);
Se l'utente specifica un nome di file e fa clic sul pulsante OK , il valore restituito è diverso da zero. Il buffer a cui puntato il membro lpstrFile della struttura OPENFILENAME contiene il percorso completo e il nome file specificato dall'utente.
Se l'utente annulla o si chiude la finestra di dialogo di salvataggio o si verifica un errore, il valore restituito è zero. Per ottenere informazioni sull'errore esteso, chiamare la funzione CommDlgExtendedError , che può restituire uno dei seguenti valori:
| 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 |
Per impostazione predefinita, Windows 95 e Windows NT versione 4.0 visualizzare una nuova versione della finestra di dialogo Salva che fornisce funzionalità di interfaccia utente simile a Windows Explorer. È possibile fornire una routine di hook OFNHookProc per una finestra di dialogo stile Explorer Salva . Per abilitare la routine di hook, impostare il flag OFN_EXPLORER e OFN_ENABLEHOOK nel membro Flags della struttura OPENFILENAME e specificare l'indirizzo della procedura gancio nel membro lpfnHook.
Windows 95 e Windows NT 4.0 continuare a sostenere il vecchio stile di dialogo Salva per le applicazioni che si desidera mantenere un'interfaccia utente coerente con Windows 3.1 o Windows NT 3.51 interfaccia utente. Per visualizzare la finestra di dialogo Salva vecchio stile, attivare una procedura di gancio OFNHookProcOldStyle e verificare che il flag OFN_EXPLORER non è impostato.
Windows CE: Non tutti i membri della struttura OPENFILENAME sono definiti in Windows CE. Per informazioni sui membri definiti, vedere l'argomento di riferimento per la struttura OPENFILENAME .
nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.
Comune di dialogo casella libreria panoramica, funzioni di Box di dialogo comuni, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME
Rimedio: Inserire il CD-ROM CD di MSDN Library.