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

Статья
11/20/2024

Вызывает стандартное диалоговое окно занято, что позволяет пользователю управлять параллелизмом.

Синтаксис

UINT OleUIBusyW(
  [in] LPOLEUIBUSYW unnamedParam1
);

Параметры

[in] unnamedParam1

Указатель на структуру OLEUIBUSY, содержащую сведения, используемые для инициализации диалогового окна.

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

Эта функция возвращает следующие значения:

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

Возвращаемый код	Описание
OLEUI_FALSE	Неизвестный сбой (неиспользуемый).
OLEUI_SUCCESS	Нет ошибок, аналогичных OLEUI_OK.
OLEUI_OK	Пользователь нажимал кнопку ОК.
OLEUI_CANCEL	Пользователь нажимал кнопку отмены и что вызывающий объект должен отменить операцию.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажимал переключиться на и OleUIBusy не удалось определить, как переключиться в блокирующее приложение. В этом случае вызывающий объект должен принять меры, чтобы попытаться устранить конфликт, если это возможно, или повторить операцию. OleUIBusy возвращает только OLEUI_BZ_SWITCHTOSELECTED, если пользователь нажал кнопку "Переключиться на", hTaskNULL и установлен флаг BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажимал переключиться на и OleUIBusy не удалось определить, как переключиться в блокирующее приложение. В этом случае вызывающий объект должен принять меры, чтобы попытаться устранить конфликт, если это возможно, или повторить операцию. OleUIBusy возвращает только OLEUI_BZ_SWITCHTOSELECTED, если пользователь нажал кнопку "Переключиться на", hTaskNULL и установлен флаг BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажимал переключиться на и OleUIBusy не удалось определить, как переключиться в блокирующее приложение. В этом случае вызывающий объект должен принять меры, чтобы попытаться устранить конфликт, если это возможно, или повторить операцию. OleUIBusy возвращает только OLEUI_BZ_SWITCHTOSELECTED, если пользователь нажал кнопку "Переключиться на", hTaskNULL и установлен флаг BZ_NOTRESPONDING.
OLEUI_BZ_RETRYSELECTED	Пользователь либо нажимал кнопку повторить попытку или попытаться устранить конфликт (вероятно, переключившись на блокирующее приложение). В этом случае вызывающий объект должен повторить операцию.
OLEUI_BZ_CALLUNBLOCKED	Диалоговое окно было проинформировано о том, что операция больше не заблокирована.

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

Возвращаемый код	Описание
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. Это значение позволяет приложению тестировать стандартные сообщения для отображения сообщений об ошибках пользователю.
OLEUI_BZERR_HTASKINVALID	Значение hTask, указанное в элементе hTask структуры OLEUIBUS Y, недопустимо.

Замечания

Стандартное диалоговое окно OLE Server "Занято" уведомляет пользователя о том, что серверное приложение не получает сообщения. Затем диалоговое окно просит пользователя отменить операцию, переключиться на задачу, заблокированную или продолжить ожидание.

Заметка

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

Требования

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

См. также

OLEUIBUSY

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