Функция OleUIPromptUserA (oledlg.h)

Статья
11/20/2024

Отображает диалоговое окно с указанным шаблоном и возвращает ответ (идентификатор кнопки) от пользователя. Эта функция используется для отображения предупреждений OLE, например "Класс не зарегистрирован".

Синтаксис

int OleUIPromptUserA(
  [in] int  nTemplate,
  [in] HWND hwndParent,
       ...  
);

Параметры

[in] nTemplate

Номер ресурса отображаемого диалогового окна. См. примечания.

[in] hwndParent

Дескриптор родительского окна диалогового окна.

...

Необязательный. Заголовок диалогового окна, за которым следует список аргументов для строки форматирования в статическом элементе управления (IDC_PU_TEXT) диалогового окна. Вызывающий объект должен обязательно передать правильное число и типы аргументов.

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

Стандартные определения успешности и ошибок

Возвращаемый код	Описание
OLEUI_FALSE	Неизвестный сбой (неиспользуемый).
OLEUI_OK	Пользователь нажимал кнопку ОК.
OLEUI_SUCCESS	Нет ошибок, аналогичных OLEUI_OK.
OLEUI_CANCEL	Пользователь нажимал кнопку "Отмена".

Ошибки проверки стандартных полей

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMIN	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_ERR_STRUCTURENULL	Указатель на структуру OLEUIXXX, переданную в функцию, был null.
OLEUI_ERR_STRUCTUREINVALID	Недостаточно разрешений для доступа на чтение или запись к структуре OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT	Неверное значение cbstruct.
OLEUI_ERR_HWNDOWNERINVALID	Недопустимое значение hWndOwner.
OLEUI_ERR_LPSZCAPTIONINVALID	Значение lpszCaption недопустимо.
OLEUI_ERR_LPFNHOOKINVALID	Недопустимое значение lpfnHook.
OLEUI_ERR_HINSTANCEINVALID	Недопустимое значение hInstance.
OLEUI_ERR_LPSZTEMPLATEINVALID	Недопустимое значение lpszTemplate.
OLEUI_ERR_HRESOURCEINVALID	Недопустимое значение hResource.

Ошибки инициализации

Возвращаемый код	Описание
OLEUI_ERR_FINDTEMPLATEFAILURE	Не удалось найти шаблон диалогового окна.
OLEUI_ERR_LOADTEMPLATEFAILURE	Не удалось загрузить шаблон диалогового окна.
OLEUI_ERR_DIALOGFAILURE	Сбой инициализации диалогового окна.
OLEUI_ERR_LOCALMEMALLOC	Сбой вызова LocalAlloc или стандартного IMalloc распределителя.
OLEUI_ERR_GLOBALMEMALLOC	Сбой вызова GlobalAlloc или стандартного распределителя IMalloc.
OLEUI_ERR_LOADSTRING	Не удалось вызвать LoadString для локализованных ресурсов из библиотеки.
OLEUI_ERR_OLEMEMALLOC	Сбой вызова стандартного IMalloc распределителя.

Ошибки, связанные с конкретной функцией

Возвращаемый код	Описание
OLEUI_ERR_STANDARDMAX	Ошибки, распространенные для всех диалоговых окон, лежат в диапазоне OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.

Замечания

В руководстве по проектированию программного обеспечения для разработки программного обеспечения определены следующие шаблоны диалоговых окон. Параметр nTemplate должен быть в настоящее время определенным ресурсом, однако для запроса.dlg можно добавить дополнительные шаблоны.

IDD_LINKSOURCEUNAVAILABLE 
IDD_CANNOTUPDATELINK 
IDD_SERVERNOTREG 
IDD_CANNOTRESPONDVERB 
IDD_SERVERNOTFOUND

Заметка

Заголовок oledlg.h определяет OleUIPromptUser как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	oledlg.h
библиотеки	OleDlg.lib
DLL	OleDlg.dll

Поделиться через