De GetSaveFileName functie maakt een gemeenschappelijk dialoogvenster Opslaan waarmee de gebruiker opgeven van het station, map en naam van een bestand op te slaan.
BOOL GetSaveFileName () LPOPENFILENAME lpofn / / adres van structuur met initialisatie / / gegevens);
Als de gebruiker een bestandsnaam moet worden opgegeven en op de knop OK klikt, wordt de retourwaarde is aan nul. De buffer waarnaar wordt verwezen door het lid lpstrFile van de NAAMOPENBESTAND structuur bevat het volledige pad en de bestandsnaam opgegeven door de gebruiker.
Als de gebruiker annuleert of sluit u het dialoogvenster Opslaan of een fout optreedt, is de retourwaarde nul. Om uitgebreide foutinformatie, roept de functie CommDlgExtendedError , die in één van de volgende waarden resulteren kan:
| 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 |
Standaard weergeven Windows 95 en Windows NT versie 4.0 een nieuwe versie van het dialoogvenster Opslaan waarmee gebruikersinterface functies die vergelijkbaar met de Windows Verkenner zijn. U kunt een OFNHookProc haak procedure voorzien in een dialoogvenster Verkenner-stijl Opslaan . Opdat de haak procedure, de OFN_EXPLORER en OFN_ENABLEHOOK vlaggen instellen in de vlaggen lid van de NAAMOPENBESTAND structuur en geef het adres van de haak-procedure in de lpfnHook lid.
Windows 95 en Windows NT 4.0 blijven de oude-stijl in het dialoogvenster Opslaan voor toepassingen die willen handhaven een user-interface consistent met de Windows 3.1 of Windows NT 3.51 user-interface ondersteunen. De oude-stijl in het dialoogvenster Opslaan weergegeven, een OFNHookProcOldStyle haak procedure inschakelen en ervoor zorgen dat de vlag OFN_EXPLORER is niet ingesteld.
Windows CE: Niet alle leden van de NAAMOPENBESTAND structuur zijn in Windows CE gedefinieerd. Zie het onderwerp voor de NAAMOPENBESTAND structuur voor informatie over de gedefinieerde leden,.
nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in commdlg.h.
Bibliotheek importeren:Gebruik comdlg32.lib.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.
Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijk dialoogvenster vak functies, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENBESTANDSNAAM