הפונקציה CommDlgExtendedError מחזירה קוד שגיאה בתיבת הדו-שיח נפוצות. קוד זה מציין את השגיאה האחרונה להתרחש במהלך הביצוע של אחת הפונקציות הנפוצות הבאות בתיבת הדו-שיח:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| FindText | PrintDlg |
| החלפת טקסט תחת | 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 הוגדר חבר בדגלים של מבנה אתחול עבור תיבת הדו-שיח נפוצות המתאים, אך הוא נכשל לספק מצביע לשגרה הוו המתאים. |
| 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 והחלפת טקסט תחת:
| ערך | משמעות |
|---|---|
| FRERR_BUFFERLENGTHZERO | חבר המבנה FINDREPLACE מצביע על מאגר לא חוקי. |
חלונות CE: Windows CE תומך ארבעה ערכי ההחזרה נוספים
ערכי ההחזרה הבאים חלים רק על הפונקציה PrintDlg:
Windows CE אינו תומך את ערכי ההחזרה CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE או CDERR_REGISTERMSGFAIL.
Windows CE אינו תומך כל ערכי השגיאה PDERR_.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על commdlg.h.
ייבוא ספריית:השתמש comdlg32.lib.
סקירה נפוצות על תיבת הדו-שיח ספריית, פונקציות נפוצות של תיבת הדו-שיח, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, הפרמטר OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, החלפת טקסט תחת