Функція 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 був встановлений в прапори членом ініціалізації структури для відповідного Загальні діалогового вікна, але ви не змогли надати вказівник на відповідний порядок гачок. |
| CDERR_NOTEMPLATE | Прапор ENABLETEMPLATE був встановлений в прапори членом ініціалізації структури для відповідного Загальні діалогового вікна, але ви не змогли надати відповідний шаблон. |
| CDERR_REGISTERMSGFAIL | Функція RegisterWindowMessage повернула код помилки, коли його називали на загальних діалоговому вікні функції. |
| CDERR_STRUCTSIZE | Неприпустимий ініціалізації структури для відповідного Загальні діалогового вікна, член lStructSize. |
Таких кодів помилки може бути повернений для PrintDlg функції:
| Значення | Значення |
|---|---|
| PDERR_CREATEICFAILURE | PrintDlg функції не вдалося, коли його спроба створити контекст інформації. |
| PDERR_DEFAULTDIFFERENT | Називається функція PrintDlg з DN_DEFAULTPRN прапор, вказаний у DEVNAMES структурі, член wDefault , але принтера, описана структура членів не відповідає поточному принтер за промовчанням. (Ця помилка виникає, коли ви зберігаєте 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 | Розмір, вказаний у CHOOSEFONT структурі, член nSizeMax є меншим за розмір, вказаний у nSizeMin член. |
| CFERR_NOFONTS | Шрифти не існують. |
Таких кодів помилки може бути повернений для GetOpenFileName та GetSaveFileName функцій:
| Значення | Значення |
|---|---|
| FNERR_BUFFERTOOSMALL | Буфер, вказав на OPENFILENAME структури, член lpstrFile є занадто мала для файлу, визначених користувачем. Перші два байти буфера 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