Функция CommDlgExtendedError

Функция CommDlgExtendedError возвращает код ошибки стандартного диалогового окна. Этот код указывает самую последнюю ошибку, которая произошла в ходе выполнения в одной из  функций стандартного диалогового окна. Коды этих ошибок определены в файле Cderr.h.

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

Если функция стандартного диалогового окна возвратила значение ЛОЖЬ (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 был установлен в члеге Flags структуры инициализации для соответствующего стандартного диалогового окна, но вы не сумели предоставить соответствующий дескриптор экземпляра окна.
CDERR_NOHOOK	Флажок ENABLEHOOK был установлен в члене Flags структуры инициализации для соответствующего стандартного диалогового окна, но вы не сумели предоставить указатель на соответствующую фильтр - процедуру.
CDERR_NOTEMPLATE	Флажок ENABLETEMPLATE был установлен в члене Flags структуры инициализации для соответствующего стандартного диалогового окна, но вы не сумели предоставить соответствующий шаблон.
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 потерпел неудачу.
PDERR_INITFAILURE	Функция PrintDlg потерпела неудачу в ходе инициализации, и больше нет специфического расширенного кода ошибки, который описывает сбой. Это событие генерирует код ошибки для функции заданный по умолчанию.
PDERR_LOADDRVFAILURE	Функция PrintDlg не сумела загрузить драйвер устройства для заданного принтера.
PDERR_NODEFAULTPRN	Принтера по умолчанию не существует.
PDERR_NODEVICES	Драйверы принтера не были найдены.
PDERR_PARSEFAILURE	Функция PrintDlg не сумела разобрать строчки в разделе [devices] файла WIN.INI.
PDERR_PRINTERNOTFOUND	Раздел [devices] файла WIN.INI не содержит записи для требуемого принтера.
PDERR_RETDEFFAILURE	Флажок PD_RETURNDEFAULT был определен в члене Flags структуры PRINTDLG, однако член hDevMode или hDevNames не был установлен в значение ПУСТО (NULL).
PDERR_SETUPFAILURE	Функция PrintDlg не сумела загрузить требуемые ресурсы.

Ниже перечислены коды ошибок, которые могут быть возвращены функцией ChooseFont.

 

Значение	Предназначение
CFERR_MAXLESSTHANMIN	Размер, заданный в члене nSizeMax структуры CHOOSEFONT меньше, чем размер установленный в члене nSizeMin.
CFERR_NOFONTS	Шрифты не существуют.

Ниже перечислены коды ошибок, которые могут быть возвращены функциями GetOpenFileName и GetSaveFileName.

Значение	Предназначение
FNERR_BUFFERTOOSMALL	Буфер, указанный членом lpstrFile структуры OPENFILENAME слишком маленький для имени файла, заданного пользователем. Первые два байта буфера lpstrFile содержат целочисленное значение, определяющее размер, в символах (TCHARs), необходимых, чтобы принять полностью имя файла.
FNERR_INVALIDFILENAME	Недопустимое имя файла.
FNERR_SUBCLASSFAILURE	Попытка поделить на подклассы окно со списком потерпела неудачу, потому что было не доступно необходимое количество памяти.

Ниже перечислены коды ошибок, которые могут быть возвращены функциями FindText и ReplaceText.

Значение	Предназначение
FRERR_BUFFERLENGTHZERO	Член структуры FINDREPLACE указывает на недопустимый буфер.

Обзор Библиотека стандартных диалоговых окон, Функции, используемые библиотекой стандартных диалоговых окон, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText