CommDlgExtendedError

DWORD CommDlgExtendedError(VOID)

Возвращаемое значение

Если последнее обращение к функции диалогового окна произошло успешно, возвращаемое значение не определено. Если функция диалогового окна возвратила значение FALSE из-за того, что диалоговое окно было закрыто без сохранения информации, возвращает нулевое значение. В противном случае возвращает одно из следующих значений:

0. Приведённые ниже коды ошибок могут быть возвращены для любого стандартного диалогового окна:

• CDERR_DIALOGFAILURE — диалоговое окно не может быть создано. Вызов макроса DialogBox в функции диалогового окна завершилось с ошибкой. Например, эта ошибка может быть связана с тем, что функции диалогового окна было передано некорректное значение дескриптора окна.

• CDERR_FINDRESFAILURE — функция диалогового окна не смогла обнаружить указанный ресурс.

• CDERR_INITIALIZATION — инициализация диалогового окна завершилась с ошибкой. Обычно эта ошибка связана с отсутствием достаточного объёма свободной оперативной памяти.

• CDERR_LOADRESFAILURE — функция диалогового окна не смогла загрузить указанный ресурс.

• CDERR_LOADSTRFAILURE — функция диалогового окна не смогла загрузить указанную строку.

• CDERR_LOCKRESFAILURE — функция диалогового окна не смогла заблокировать указанный ресурс.

• CDERR_MEMALLOCFAILURE — функция диалогового окна не смогла выделить достаточный объём оперативной памяти для хранения внутренних структур.

• CDERR_MEMLOCKFAILURE — функция диалогового окна не смогла заблокировать область оперативной памяти, связанной с дескриптором.

• CDERR_NOHINSTANCE — в переменной Flags объекта структуры инициализации, соответствующей данному типу диалогового окна, установлен флаг ENABLETEMPLATE, но не указан соответствующий дескриптор экземпляра.

• CDERR_NOHOOK — в переменной Flags объекта структуры инициализации, соответствующей данному типу диалогового окна, установлен флаг ENABLEHOOK, но отсутствует указатель на соответствующую функцию обратного вызова.

• CDERR_NOTEMPLATE — в переменной Flags объекта структуры инициализации, соответствующей данному типу диалогового окна, установлен флаг ENABLETEMPLATE, но не задан соответствующий шаблон.

• CDERR_REGISTERMSGFAIL — функция RegisterWindowMessage возвратила значение ошибки при вызове её функцией диалогового окна.

• CDERR_STRUCTSIZE — в переменной lStructSize объекта структуры инициализации, соответствующей данному типу диалогового окна, содержится некорректное значение.

0. Приведённые ниже коды ошибок могут быть возвращены после вызова функции PrintDlg.

• PDERR_CREATEICFAILURE — ошибка возникла при попытке создания функцией PrintDlg информационного контекста.

• PDERR_DEFAULTDIFFERENT — при вызове функции PrintDlg в переменной wDefault объекта структуры DEVNAMES установлен флаг DN_DEFAULTPRN, но принтер, описываемый, другими переменными данной структуры не соответствует по своим параметрам принтеру, выбираемому по умолчанию. (Эта ошибка возникает в том случае, когда объект структуры DEVNAMES сохраняется в оперативной памяти, а пользователь изменяет в Панели управления выбираемый по умолчанию принтер.)

0. Для использования принтера, описанного в объекте структуры DEVNAMES, следует сбросить флаг DN_DEFAULTPRN и снова вызвать функцию PrintDlg.

1. Для использования принтера, выбираемого по умолчанию, передайте нулевой указатель на объект структуры DEVNAMES (и на объект структуры DEVMODE, если он существует) и снова вызвать функцию PrintDlg.

• PDERR_DNDMMISMATCH — переменные объектов структур DEVMODE и DEVNAMES описывают два различных принтера.

• PDERR_GETDEVMODEFAIL — драйвер принтера не может инициализировать объект структуры DEVMODE. (Этот код ошибки применим только к драйверам принтеров, написанным для Windows версии 3.0 и более поздних версий.)

• PDERR_INITFAILURE — ошибка при вызове функции PrintDlg возникла в процессе инициализации и отсутствует специальные код для возникшей ошибки. Этот код ошибки используется для данной функции по умолчанию.

• PDERR_LOADDRVFAILURE — функция PrintDlg не смогла загрузить драйвер устройства для указанного принтера.

• PDERR_NODEFAULTPRN — отсутствует принтер, выбираемый по умолчанию.

• PDERR_NODEVICES — отсутствуют драйверы принтеров.

• PDERR_PARSEFAILURE — возникла ошибка при синтаксическом разборе строки в секции [devices] файла win.ini.

• PDERR_PRINTERNOTFOUND — в секции [devices] файла win.ini отсутствует запись для указанного принтера.

• PDERR_RETDEFFAILURE — в переменной Flags объект структуры PRINTDLG установлен флаг PD_RETURNDEFAULT, но переменная hDevMode или переменная hDevNames имеют ненулевое значение.

• PDERR_SETUPFAILURE — функция PrintDlg не смогла загрузить требуемые ресурсы.

0. Приведённые ниже коды ошибок могут быть возвращены после вызова функции ChoseFont:

• CFERR_MAXLESSTHANMIN — размер, указанный в переменной nSizeMax объекта структуры CHOOSEFONT, меньше размера, указанного в переменной nSizeMin.

• CFERR_NOFONTS — шрифты отсутствуют.

0. Приведённые ниже коды ошибок могут быть возвращены после вызова функций GetOpenFileName и GetSaveFileName:

• FNERR_BUFFERTOOSMALL — буфер, на который указывает переменная lpstrFile объекта структуры OPENFILENAME, имеет недостаточный размер для размещения введённого пользователем имени файла. Первые два байта буфера lpstrFile содержат целочисленную величину, определяющую его размер в байтах (версия ANSI) или в 16-битовых символах (версия Unicode).

• FNERR_INVALIDFILENAME — использовано недопустимое имя файла.

• FNERR_SUBCLASSFAILURE — попытка разделить окно списка на подклассы завершилась с ошибкой по причине отсутствия необходимого объёма оперативной памяти.

0. Приведённые ниже коды ошибок могут быть возвращены после вызова функций FindText и ReplaceText:

• FRERR_BUFFERLENGTHZERO — переменная объекта структуры FINDREPLACE указывает на недопустимый буфер.

Примечание

Функция CommDlgExtendedError возвращает коды ошибок, возникших при работе со стандартными диалоговыми окнами. Возвращаемое значение соответствует коду последней ошибки, возникшей при выполнении функций ChooseColor, ChoseFont, FindText, ReplaceText, GetOpenFileName, GetSaveFileName, PrintDlg и PageSetupDlg.

Значения кодов ошибки, возвращаемые функцией CommDlgExtendedError, определены в файле заголовка cderr.h.

Описание данной функции содержится в файле заголовка commdlg.h. Данная функция включается как ресурс в библиотеку динамической компоновки commdlg32.dll.