GetSaveFileNameA-Funktion (commdlg.h)

Artikel
11/20/2024

[Ab Windows Vista wurden die Öffnen und Allgemeinen Dialogfelder "Speichern unter" durch das Dialogfeld "Allgemeines Element"ersetzt. Es wird empfohlen, anstelle dieser Dialogfelder aus der Allgemeinen Dialogfeldbibliothek die Api für das allgemeine Elementdialogfeld zu verwenden.]

Erstellt ein dialogfeld Speichern, in dem der Benutzer das Laufwerk, das Verzeichnis und den Namen einer zu speichernden Datei angeben kann.

Syntax

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

Parameter

[in, out] unnamedParam1

Typ: LPOPENFILENAME

Ein Zeiger auf eine OPENFILENAME- Struktur, die Informationen enthält, die zum Initialisieren des Dialogfelds verwendet werden. Wenn GetSaveFileName zurückgegeben wird, enthält diese Struktur Informationen zur Dateiauswahl des Benutzers.

Rückgabewert

Typ: BOOL-

Wenn der Benutzer einen Dateinamen angibt und auf die Schaltfläche OK klickt und die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null. Der Puffer, der vom lpstrFile Member der OPENFILENAME Struktur verweist, enthält den vollständigen Pfad und Dateinamen, der vom Benutzer angegeben wird.

Wenn der Benutzer das Dialogfeld "Speichern speichern" abbricht oder schließt, tritt ein Fehler auf, z. B. der Dateinamenpuffer, der zu klein ist, der Rückgabewert null. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die CommDlgExtendedError-Funktion auf, die einen der folgenden Werte zurückgeben kann:

Bemerkungen

Das Explorer-Format Dialogfeld " speichern", das Benutzeroberflächenfeatures bereitstellt, die dem Windows-Explorer ähneln. Sie können eine OFNHookProc- Hook-Prozedur für ein Explorer-Format Dialogfeld " speichern" bereitstellen. Um die Hook-Prozedur zu aktivieren, legen Sie die OFN_EXPLORER- und OFN_ENABLEHOOK Flags im Flags Mitglied der OPENFILENAME Struktur fest und geben Sie die Adresse der Hook-Prozedur im lpfnHook Member an.

Windows unterstützt weiterhin alte Dialogfelder " speichern" für Anwendungen, die eine Benutzeroberfläche beibehalten möchten, die mit der Benutzeroberfläche des alten Stils konsistent ist. Um das Dialogfeld Speichern anzuzeigen, aktivieren Sie eine OFNHookProcOldStyle Hook-Prozedur, und stellen Sie sicher, dass das OFN_EXPLORER Flag nicht festgelegt ist.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer erweiterten Metadatei.

Anmerkung

Der commdlg.h-Header definiert GetSaveFileName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commdlg.h (enthalten Windows.h)
Library	Comdlg32.lib
DLL-	Comdlg32.dll
API-Satz	ext-ms-win-shell-comdlg32-l1-1-1 (eingeführt in Windows 10, Version 10.0.14393)