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

Статья
08/25/2023

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

Синтаксис

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

Параметры

[in] unnamedParam1

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

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

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

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

Код возврата	Описание
OLEUI_FALSE	Неизвестный сбой (неиспользуемый).
OLEUI_SUCCESS	Ошибка отсутствует, как и OLEUI_OK.
OLEUI_OK	Пользователь нажал кнопку ОК .
OLEUI_CANCEL	Пользователь нажал кнопку Отмена и что вызывающий объект должен отменить операцию.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажал Switch To и OleUIBusy не смог определить, как переключиться на блокирующее приложение. В этом случае вызывающий объект должен либо принять меры, чтобы попытаться разрешить сам конфликт, если это возможно, либо повторить операцию. OleUIBusy возвращает OLEUI_BZ_SWITCHTOSELECTED только в том случае, если пользователь нажал кнопку Переключиться , hTask имеет значение NULL и установлен флаг BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажал Switch To и OleUIBusy не смог определить, как переключиться на блокирующее приложение. В этом случае вызывающий объект должен либо принять меры, чтобы попытаться разрешить сам конфликт, если это возможно, либо повторить операцию. OleUIBusy возвращает OLEUI_BZ_SWITCHTOSELECTED только в том случае, если пользователь нажал кнопку Переключиться , hTask имеет значение NULL и установлен флаг BZ_NOTRESPONDING.
OLEUI_BZ_SWITCHTOSELECTED	Пользователь нажал Switch To и OleUIBusy не смог определить, как переключиться на блокирующее приложение. В этом случае вызывающий объект должен либо принять меры, чтобы попытаться разрешить сам конфликт, если это возможно, либо повторить операцию. OleUIBusy возвращает OLEUI_BZ_SWITCHTOSELECTED только в том случае, если пользователь нажал кнопку Переключиться , hTask имеет значение NULL и установлен флаг 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 структуры OLEUIBUSY .

Код возврата

Описание

OLEUI_ERR_STANDARDMAX

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

OLEUI_BZERR_HTASKINVALID

Недопустимый объект hTask, указанный в элементе hTask структуры OLEUIBUSY .

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	oledlg.h
Библиотека	OleDlg.lib
DLL	OleDlg.dll

См. также раздел

OLEUIBUSY

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