ฟังก์ชันGetSaveFileNameสร้างบันทึกทั่วไปกล่องโต้ตอบที่ช่วยให้ผู้ใช้ระบุตัวไดรฟ์ directory และชื่อของแฟ้มบันทึก.
(BOOL GetSaveFileName LPOPENFILENAME lpofn / / ที่อยู่ของโครงสร้างที่มีการเตรียมใช้งาน / / ข้อมูล);
ถ้าผู้ใช้ระบุชื่อแฟ้ม และคลิกปุ่มOKค่าส่งกลับจะไม่ใช่ศูนย์ บัฟเฟอร์ที่ชี้ไป โดยสมาชิกlpstrFileของโครงสร้างOPENFILENAMEไม่ประกอบด้วยพาธเต็มและชื่อแฟ้มที่ระบุ โดยผู้ใช้.
ถ้าผู้ใช้ยกเลิก หรือปิดกล่องโต้ตอบบันทึกหรือมีข้อผิดพลาดเกิดขึ้น ค่าส่งกลับเป็นศูนย์ การรับข้อมูลความผิดพลาดแบบขยาย เรียกใช้ฟังก์ชันCommDlgExtendedErrorซึ่งสามารถส่งกลับหนึ่งในค่าต่อไปนี้:
| 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 |
โดยค่าเริ่มต้น Windows 95 และ Windows NT 4.0 รุ่นแสดงรุ่นใหม่ของกล่องโต้ตอบบันทึกที่มีคุณลักษณะของอินเทอร์เฟซสำหรับผู้ใช้ที่คล้ายกับ Windows Explorer คุณสามารถจัดเป็นขั้นตอนของ hook OFNHookProcสำหรับกล่องโต้ตอบการ Explorer แบบบันทึก เมื่อต้องการเปิดการใช้งานในขั้นตอนของ hook ตั้งค่าสถานะ OFN_EXPLORER และ OFN_ENABLEHOOK ในสถานะสมาชิกของโครงสร้างOPENFILENAMEและระบุอยู่ของขั้นตอนของ hook ในสมาชิกlpfnHook.
Windows 95 และ Windows NT 4.0 ยังสนับสนุนการแบบกล่องโต้ตอบบันทึกสำหรับโปรแกรมประยุกต์ที่ต้องการรักษาแบบส่วนติดต่อผู้ใช้ที่สอดคล้องกับ Windows 3.1 หรือส่วนติดต่อผู้ใช้ของ Windows NT 3.51 เมื่อต้องการแสดงในแบบกล่องโต้ตอบบันทึกการเปิดใช้งานเป็นขั้นตอนของ hook OFNHookProcOldStyleและให้แน่ใจว่า ไม่ตั้งค่าสถานะ OFN_EXPLORER.
Windows CE: โครงสร้างOPENFILENAMEสมาชิกทั้งหมดไม่มีกำหนดใน Windows CE สำหรับข้อมูลเกี่ยวกับการกำหนดสมาชิก ดูหัวข้ออ้างอิงสำหรับโครงสร้างOPENFILENAME .
nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการเวอร์ชัน 1.0 หรือรุ่นใหม่กว่า
หัวข้อ:ประกาศใน commdlg.h
ไลบรารีที่นำเข้า:ใช้ comdlg32.lib
Unicode:นำมาใช้เป็น Unicode และ ANSI รุ่นบน Windows NT.
ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปฟังก์ชันกล่องโต้ตอบทั่วไป CommDlgExtendedError, GetOpenFilename, OFNHookProc, OFNHookProcOldStyle, OPENFILENAME