ฟังก์ชันCommDlgExtendedErrorจะส่งกลับรหัสข้อผิดพลาดในกล่องโต้ตอบทั่วไป รหัสนี้บ่งชี้ข้อผิดพลาดล่าสุดเกิดขึ้นในระหว่างการดำเนินการของฟังก์ชันทั่วไปโต้ตอบกล่องต่อไปนี้:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| FindText | PrintDlg |
| ReplaceText | PageSetupDlg |
DWORD CommDlgExtendedError(VOID)
ฟังก์ชันนี้ได้ไม่มีพารามิเตอร์.
ถ้าโทรล่าสุดไปยังฟังก์ชันในกล่องโต้ตอบที่ทั่วไปได้สำเร็จ ค่าส่งกลับจะไม่ได้กำหนด.
ถ้าฟังก์ชันในกล่องโต้ตอบทั่วไปส่งกลับค่า FALSE เนื่องจากผู้ใช้ที่ปิด หรือยกเลิกกล่องโต้ตอบ ส่งคืนค่าเป็นศูนย์ มิฉะนั้น ค่าส่งกลับเป็นรหัสข้อผิดพลาดที่ไม่ใช่ศูนย์ สำหรับข้อมูลเพิ่มเติม ให้ดูในส่วนข้อสังเกตต่อไปนี้.
ฟังก์ชันCommDlgExtendedErrorสามารถส่งกลับรหัสข้อผิดพลาดทั่วไปของฟังก์ชันในกล่องโต้ตอบทั่วไป นอกจากนี้ มีรหัสข้อผิดพลาดที่มีการส่งกลับเฉพาะสำหรับกล่องโต้ตอบทั่วไปเฉพาะ มีกำหนดรหัสข้อผิดพลาดถูกส่งกลับโดยCommDlgExtendedErrorในการ CDERRแฟ้ม H.
สามารถส่งกลับรหัสข้อผิดพลาดทั่วไปต่อไปนี้ของฟังก์ชันในกล่องโต้ตอบทั่วไป:
| ค่า | ความหมาย |
|---|---|
| CDERR_DIALOGFAILURE | ไม่สามารถสร้างกล่องโต้ตอบ ทั่วไปโต้ตอบกล่องฟังก์ชันของการเรียกไปยังฟังก์ชันDialogBoxล้มเหลว ตัวอย่างเช่น ข้อผิดพลาดนี้เกิดขึ้นหากการเรียกกล่องโต้ตอบทั่วไประบุตัวเลขอ้างอิงของหน้าต่างไม่ถูกต้อง. |
| CDERR_FINDRESFAILURE | ไม่สามารถค้นหาทรัพยากรที่ระบุฟังก์ชันในกล่องโต้ตอบทั่วไป. |
| CDERR_INITIALIZATION | ฟังก์ชันในกล่องโต้ตอบทั่วไปล้มเหลวในระหว่างการเตรียมใช้งาน นอกจากนี้ข้อผิดพลาดนี้มักเกิดเมื่อไม่มีหน่วยความจำที่เพียงพอ. |
| CDERR_LOADRESFAILURE | ไม่สามารถโหลดทรัพยากรที่ระบุฟังก์ชันในกล่องโต้ตอบทั่วไป. |
| CDERR_LOADSTRFAILURE | ไม่สามารถโหลดสตริงที่ระบุฟังก์ชันในกล่องโต้ตอบทั่วไป. |
| CDERR_LOCKRESFAILURE | ฟังก์ชันในกล่องโต้ตอบทั่วไปไม่สามารถล็อกทรัพยากรที่ระบุ. |
| CDERR_MEMALLOCFAILURE | ฟังก์ชันในกล่องโต้ตอบทั่วไปไม่สามารถจัดสรรหน่วยความจำสำหรับโครงสร้างภายใน. |
| CDERR_MEMLOCKFAILURE | ฟังก์ชันในกล่องโต้ตอบทั่วไปไม่สามารถล็อกหน่วยความจำเกี่ยวข้องกับการจัดการ. |
| CDERR_NOHINSTANCE | ตั้งค่าสถานะ ENABLETEMPLATE ถูกตั้งค่าในสถานะสมาชิกของโครงสร้างการเตรียมใช้งานสำหรับกล่องโต้ตอบที่เกี่ยวข้องทั่วไป แต่คุณไม่สามารถใส่หมายเลขอ้างอิงอินสแตนซ์ที่สอดคล้องกัน. |
| CDERR_NOHOOK | ตั้งค่าสถานะ ENABLEHOOK ถูกตั้งค่าในสถานะสมาชิกของโครงสร้างการเตรียมใช้งานสำหรับกล่องโต้ตอบที่เกี่ยวข้องทั่วไป แต่คุณไม่สามารถใส่ตัวชี้ไปยังขั้นตอนของ hook สอดคล้องกัน. |
| CDERR_NOTEMPLATE | ค่าสถานะ ENABLETEMPLATE ถูกตั้งค่าในสถานะสมาชิกของโครงสร้างการเตรียมใช้งานสำหรับกล่องโต้ตอบที่เกี่ยวข้องทั่วไป แต่คุณไม่สามารถแสดงแม่แบบที่สอดคล้องกัน. |
| CDERR_REGISTERMSGFAIL | ฟังก์ชันRegisterWindowMessageจะส่งกลับรหัสข้อผิดพลาดเมื่อมันถูกเรียก โดยฟังก์ชันกล่องโต้ตอบทั่วไป. |
| CDERR_STRUCTSIZE | สมาชิกlStructSizeของโครงสร้างการเตรียมใช้งานสำหรับกล่องโต้ตอบที่สอดคล้องกันทั่วไปไม่ถูกต้อง. |
สามารถส่งกลับรหัสข้อผิดพลาดต่อไปนี้สำหรับฟังก์ชันPrintDlg:
| ค่า | ความหมาย |
|---|---|
| PDERR_CREATEICFAILURE | ฟังก์ชันPrintDlgล้มเหลวเมื่อคุณพยายามสร้างตัวบริบทข้อมูล. |
| PDERR_DEFAULTDIFFERENT | คุณเรียกฟังก์ชันPrintDlgด้วยค่าสถานะ DN_DEFAULTPRN ระบุไว้ในสมาชิกwDefaultของโครงสร้างDEVNAMESแต่เครื่องพิมพ์อธิบาย โดยสมาชิกโครงสร้างอื่น ๆ ไม่ตรงกับเครื่องพิมพ์เริ่มต้นปัจจุบัน (ข้อผิดพลาดนี้เกิดขึ้นเมื่อคุณจัดเก็บโครงสร้างDEVNAMESและผู้ใช้เปลี่ยนเครื่องพิมพ์เริ่มต้น โดยใช้'แผงควบคุม') |
| การใช้เครื่องพิมพ์ที่ระบุไว้ โดยโครงสร้างDEVNAMESล้างค่าสถานะ DN_DEFAULTPRN และโทรPrintDlgอีกครั้ง. การใช้เครื่องพิมพ์เริ่มต้น แทนโครงสร้างDEVNAMES (และ โครงสร้างข้อมูล DEVMODEถ้ามีอยู่) กับ NULL และโทรPrintDlgอีกครั้ง. |
|
| PDERR_DNDMMISMATCH | ข้อมูลในโครงสร้างข้อมูล DEVMODEและDEVNAMESอธิบายถึงเครื่องพิมพ์ที่แตกต่างกันสอง. |
| PDERR_GETDEVMODEFAIL | โปรแกรมควบคุมเครื่องพิมพ์ล้มเหลวในการเตรียมใช้งานโครงสร้างข้อมูล DEVMODE (รหัสข้อผิดพลาดนี้ใช้กับโปรแกรมควบคุมเครื่องพิมพ์ที่เขียนขึ้นสำหรับ Windows รุ่น 3.0 และรุ่นใหม่กว่าเท่านั้น) |
| PDERR_INITFAILURE | ฟังก์ชันPrintDlgล้มเหลวในระหว่างการเตรียมใช้งาน และมีรหัสข้อผิดพลาดแบบขยายเฉพาะไม่มีการอธิบายถึงความล้มเหลว นี่คือรหัสข้อผิดพลาดการเริ่มต้นทั่วไปสำหรับฟังก์ชัน. |
| PDERR_LOADDRVFAILURE | ฟังก์ชันPrintDlgไม่สามารถโหลดโปรแกรมควบคุมอุปกรณ์สำหรับเครื่องพิมพ์ที่ระบุ. |
| PDERR_NODEFAULTPRN | ไม่มีเครื่องพิมพ์เริ่มต้น. |
| PDERR_NODEVICES | โปรแกรมควบคุมเครื่องพิมพ์ไม่พบ. |
| PDERR_PARSEFAILURE | ฟังก์ชันPrintDlgไม่สามารถแยกสายอักขระในส่วน [devices] ของชนะแฟ้ม INI. |
| PDERR_PRINTERNOTFOUND | ส่วน [devices] ของชนะแฟ้ม INI ไม่ประกอบด้วยรายการสำหรับเครื่องพิมพ์ที่ร้องขอ. |
| PDERR_RETDEFFAILURE | มีระบุค่าสถานะ PD_RETURNDEFAULT ในสถานะสมาชิกของโครงสร้างPRINTDLGแต่สมาชิกhDevModeหรือhDevNamesไม่ใช่ NULL. |
| PDERR_SETUPFAILURE | ฟังก์ชันPrintDlgไม่สามารถโหลดทรัพยากรจำเป็น. |
สามารถส่งกลับรหัสข้อผิดพลาดต่อไปนี้สำหรับฟังก์ชันChooseFont:
| ค่า | ความหมาย |
|---|---|
| CFERR_MAXLESSTHANMIN | ขนาดที่ระบุในสมาชิกnSizeMaxของโครงสร้างCHOOSEFONTไม่น้อยกว่าขนาดที่ระบุในสมาชิกnSizeMin. |
| CFERR_NOFONTS | ไม่มีแบบอักษรที่มีอยู่. |
สามารถส่งกลับรหัสข้อผิดพลาดต่อไปนี้สำหรับฟังก์ชันGetOpenFileNameและGetSaveFileName:
| ค่า | ความหมาย |
|---|---|
| FNERR_BUFFERTOOSMALL | บัฟเฟอร์ที่ชี้ไป โดยสมาชิกlpstrFileของโครงสร้างOPENFILENAMEไม่มีขนาดเล็กเกินไปสำหรับชื่อแฟ้มที่ระบุ โดยผู้ใช้ สองไบต์แรกของบัฟเฟอร์lpstrFileมีการระบุจำนวนเต็มมูลค่าที่ขนาด ไบต์ (รุ่น ANSI) หรืออักขระ 16 บิต (รุ่น Unicode), ต้องได้รับชื่อเต็ม. |
| FNERR_INVALIDFILENAME | ชื่อแฟ้มไม่ถูกต้อง. |
| FNERR_SUBCLASSFAILURE | ความพยายามซับคลาสกล่องรายการล้มได้เนื่องจากหน่วยความจำเพียงพอไม่พร้อมใช้งาน. |
สามารถส่งกลับรหัสข้อผิดพลาดต่อไปนี้สำหรับฟังก์ชันFindTextและReplaceText:
| ค่า | ความหมาย |
|---|---|
| FRERR_BUFFERLENGTHZERO | สมาชิกของโครงสร้างFINDREPLACEชี้การบัฟเฟอร์ที่ไม่ถูกต้อง. |
Windows CE: Windows CE สนับสนุนสี่เพิ่มเติมส่งคืนค่า
ค่าที่ส่งกลับต่อไปนี้ใช้เฉพาะกับฟังก์ชันPrintDlg:
Windows CE ไม่สนับสนุนค่าที่ส่งกลับ CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE หรือ CDERR_REGISTERMSGFAIL.
Windows CE สนับสนุนใด ๆ ของค่าความผิดพลาด PDERR_.
nbsp Windows &NT:ต้องการเวอร์ชัน 3.1 หรือรุ่นที่ใหม่กว่า
Windows:ต้องใช้ Windows 95 หรือรุ่นที่ใหม่กว่า
Windows CE:ต้องการเวอร์ชัน 1.0 หรือรุ่นใหม่กว่า
หัวข้อ:ประกาศใน commdlg.h
ไลบรารีที่นำเข้า:ใช้ comdlg32.lib.
ภาพรวมไลบรารีของกล่องโต้ตอบทั่วไปฟังก์ชันกล่องโต้ตอบทั่วไป ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText