CommDlgExtendedError

ฟังก์ชัน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 สนับสนุนสี่เพิ่มเติมส่งคืนค่า

CDERR_REGISTRYFAILURE
ฟังก์ชันในกล่องโต้ตอบทั่วไปไม่สามารถอ่านจากรีจิสทรี.

ค่าที่ส่งกลับต่อไปนี้ใช้เฉพาะกับฟังก์ชันPrintDlg:

PDERR_NOPORTS
พอร์ตไม่ถูกลงทะเบียน.
PDERR_NOPRINTERS
เครื่องพิมพ์ไม่มีการลงทะเบียน.
PDERR_CREATEDCFAILURE
ล้มเหลวในการเรียกไปยังCreateDC.

Windows CE ไม่สนับสนุนค่าที่ส่งกลับ CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE หรือ CDERR_REGISTERMSGFAIL.

Windows CE สนับสนุนใด ๆ ของค่าความผิดพลาด PDERR_.

QuickInfo

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