Функция OleUIPromptUserA (oledlg.h)
Отображает диалоговое окно с указанным шаблоном и возвращает ответ (идентификатор кнопки) от пользователя. Эта функция используется для отображения предупреждающих сообщений OLE, например " Класс не зарегистрирован".
Синтаксис
int OleUIPromptUserA(
[in] int nTemplate,
[in] HWND hwndParent,
...
);
Параметры
[in] nTemplate
Номер ресурса отображаемого диалогового окна. См. заметки.
[in] hwndParent
Дескриптор родительского окна диалогового окна.
...
Необязательный элемент. Заголовок диалогового окна, за которым следует список аргументов для строки формата в статическом элементе управления (IDC_PU_TEXT) диалогового окна. Вызывающий объект должен обязательно передать правильное число и типы аргументов.
Возвращаемое значение
Стандартные определения успешности и ошибок
Код возврата | Описание |
---|---|
|
Неизвестный сбой (неиспользуемый). |
|
Пользователь нажал кнопку ОК . |
|
Ошибка отсутствует, как и OLEUI_OK. |
|
Пользователь нажал кнопку Отмена . |
Стандартные ошибки проверки полей
Код возврата | Описание |
---|---|
|
Ошибки, общие для всех диалоговых окон, находятся в диапазоне OLEUI_ERR_STANDARDMIN для OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению проверять наличие стандартных сообщений, чтобы отображать сообщения об ошибках для пользователя. |
|
Указатель на структуру OLEUIXXX, переданную в функцию, был NULL. |
|
Недостаточно разрешений для доступа на чтение или запись к структуре OLEUIXXX. |
|
Неверное значение cbstruct . |
|
Недопустимое значение hWndOwner . |
|
Недопустимое значение lpszCaption . |
|
Недопустимое значение lpfnHook . |
|
Недопустимое значение hInstance . |
|
Недопустимое значение lpszTemplate . |
|
Недопустимое значение hResource . |
Ошибки инициализации
Код возврата | Описание |
---|---|
|
Не удается найти шаблон диалогового окна. |
|
Не удалось загрузить шаблон диалогового окна. |
|
Сбой инициализации диалогового окна. |
|
Сбой вызова LocalAlloc или стандартного распределителя IMalloc . |
|
Сбой вызова GlobalAlloc или стандартного распределителя IMalloc . |
|
Не удалось вызвать LoadString для локализованных ресурсов из библиотеки. |
|
Сбой вызова стандартного распределителя IMalloc . |
Ошибки, связанные с функциями
Код возврата | Описание |
---|---|
|
Ошибки, общие для всех диалоговых окон, находятся в диапазоне OLEUI_ERR_STANDARDMIN для OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению проверять наличие стандартных сообщений, чтобы отображать сообщения об ошибках для пользователя. |
Комментарии
Следующие шаблоны диалоговых окон определены в руководстве по интерфейсу Windows — руководстве по проектированию программного обеспечения. Параметр nTemplate должен быть текущим ресурсом, однако в файл prompt.dlg можно добавить дополнительные шаблоны.
IDD_LINKSOURCEUNAVAILABLE
IDD_CANNOTUPDATELINK
IDD_SERVERNOTREG
IDD_CANNOTRESPONDVERB
IDD_SERVERNOTFOUND
Примечание
Заголовок oledlg.h определяет OleUIPromptUser в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | oledlg.h |
Библиотека | OleDlg.lib |
DLL | OleDlg.dll |