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);
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 |
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.
&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.
Allgemeine Dialogfeld-Bibliothek – Übersicht, Funktionen der Common Dialog Box, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME