GetSaveFileName funkcia vytvára spoločné dialógové okno Uložiť , umožňuje používateľovi zadať jednotky, adresára a názov súboru na uloženie.
BOOL GetSaveFileName ( LPOPENFILENAME lpofn / / address konštrukcie s Inicializácia / / údajov);
Ak používateľ Určuje názov súboru a klikne na tlačidlo OK , vrátená hodnota je nenulové. Medzipamäť poukázal členskými lpstrFile OPENFILENAME štruktúra obsahuje úplnú cestu a názov súboru stanovenú používateľom.
Ak používateľ zruší alebo zavrie dialógové okno Uložiť alebo vyskytne chyba, vrátená hodnota je nula. Na získanie informácií o rozšírenej chybe, volajte CommDlgExtendedError funkcie môžu vrátiť jeden z nasledovných hodnôt:
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 |
V predvolenom nastavení systému Windows 95 alebo Windows NT verzia 4.0 zobrazte nová verzia dialógovom okne Uložiť poskytujúci funkcie používateľského rozhrania, ktoré sú podobné Windows Exploreru. OFNHookProc príslušná procedúra môže ustanoviť dialógové okno štýl Explorer uložte . Aby príslušná procedúra nastaviť príznak OFN_EXPLORER a OFN_ENABLEHOOK v členských štátoch vlajok OPENFILENAME štruktúry a zadať adresu príslušná procedúra v členských lpfnHook.
Systém Windows 95 alebo Windows NT 4.0 naďalej podporovať old-štýl dialógové okno Uložiť pre aplikácie, ktoré chcete ponechať používateľské rozhranie zlučiteľný s Windows 3.1 alebo Windows NT 3.51 používateľského rozhrania. Zobraziť dialógové okno Uložiť old-štýl, umožniť OFNHookProcOldStyle príslušná procedúra a aby sa zabezpečilo nie je nastavený príznak OFN_EXPLORER.
Windows CE: Nie všetci členovia OPENFILENAME štruktúry sú definované v systému Windows CE. Informácie o definované členov, nájdete v téme odkaz pre štruktúru OPENFILENAME .
nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v commdlg.h.
Importovať knižnica:Použiť comdlg32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.
Spoločné Prehľad dialógového okna Knižnica spoločných Dialog Box funkcií, CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME