GetSaveFileName

Die GetSaveFileName -Funktion erstellt ein allgemeine Dialogfeld Speichern , mit dem den Benutzer geben Sie den Laufwerk, Verzeichnis und den Namen einer Datei zu speichern.

BOOL GetSaveFileName) LPOPENFILENAME  Lpofn / / Adresse der Struktur mit der Initialisierung / / Daten);
 

Parameter

lpofn
Zeiger auf eine OPENFILENAME -Struktur, die Informationen verwendet, um das Dialogfeld zu initialisieren enthält. GetSaveFileName gibt diese Struktur enthält Informationen über die Auswahl des Benutzers Datei.

Rückgabewerte

Wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt, ist der Rückgabewert ungleich NULL. Der Puffer, auf den der LpstrFile -Member der OPENFILENAME -Struktur enthält den vollständigen Pfad und Dateinamen, die vom Benutzer angegebenen.

Wenn der Benutzer abbricht oder schließt das Dialogfeld Speichern oder ein Fehler auftritt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen abzurufen, rufen Sie die CommDlgExtendedError -Funktion, die einen der folgenden Werte zurückgeben, können:

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

Bemerkungen

Standardmäßig zeigt Windows 95 und Windows NT, Version 4.0 eine neue Version Speichern im Dialogfeld, das Benutzeroberflächen-Features bereitstellt, die den Windows-Explorer ähnlich sind. Sie können eine OFNHookProc -Hook-Prozedur für eine Explorer-Stil Speichern -Dialogfeld bereitstellen. Um die Hook-Prozedur zu aktivieren, legen Sie die Flags OFN_EXPLORER und OFN_ENABLEHOOK im Flags -Member der OPENFILENAME -Struktur, und geben Sie die Adresse der die Hook-Prozedur in der LpfnHook -member.

Windows 95 und Windows NT 4.0 weiterhin den alten Stil im Dialogfeld Speichern für Anwendungen zu unterstützen, die eine Benutzeroberfläche mit Windows 3.1 oder Windows NT 3.51-Benutzeroberfläche konsistent beibehalten werden soll. Um den alten Stil Speichern im Dialogfeld anzuzeigen, aktivieren Sie eine OFNHookProcOldStyle -Hook-Prozedur und sicherstellen Sie, dass das OFN_EXPLORER-Flag nicht gesetzt ist.

Windows CE: In Windows CE sind nicht alle Member der OPENFILENAME -Struktur definiert. Informationen über die definierten Elemente finden Sie im Referenzthema für die OPENFILENAME -Struktur.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In commdlg.h deklariert.
Importieren Bibliothek:Verwenden Sie comdlg32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Allgemeine Dialogfeld-Bibliothek – Übersicht, Funktionen der Common Dialog Box, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME

Index