OleUIBusyA 函数 (oledlg.h)

调用标准的“ 忙碌 ”对话框，允许用户管理并发。

语法

UINT OleUIBusyA(
  [in] LPOLEUIBUSYA unnamedParam1
);

参数

[in] unnamedParam1

指向包含用于初始化对话框的信息的 OLEUIBUSY 结构的指针。

返回值

此函数返回以下值：

标准成功/错误定义

返回代码	说明
OLEUI_FALSE	未知故障 (未使用的) 。
OLEUI_SUCCESS	无错误，与OLEUI_OK相同。
OLEUI_OK	用户按下了 “确定 ”按钮。
OLEUI_CANCEL	用户已按下“ 取消 ”按钮，调用方应取消该操作。
OLEUI_BZ_SWITCHTOSELECTED	用户已按下 “切换到 ”， OleUIBusy 无法确定如何切换到阻止应用程序。 在这种情况下，调用方应采取措施尝试解决冲突本身（如果可能），或者重试操作。 仅当用户按下了“切换到”按钮，hTask 为 NULL 且设置了BZ_NOTRESPONDING标志时，OleUIBusy 才会返回OLEUI_BZ_SWITCHTOSELECTED。
OLEUI_BZ_SWITCHTOSELECTED	用户已按下 “切换到 ”， OleUIBusy 无法确定如何切换到阻止应用程序。 在这种情况下，调用方应采取措施尝试解决冲突本身（如果可能），或者重试操作。 仅当用户按下了“切换到”按钮，hTask 为 NULL 且设置了BZ_NOTRESPONDING标志时，OleUIBusy 才会返回OLEUI_BZ_SWITCHTOSELECTED。
OLEUI_BZ_SWITCHTOSELECTED	用户已按下 “切换到 ”， OleUIBusy 无法确定如何切换到阻止应用程序。 在这种情况下，调用方应采取措施尝试解决冲突本身（如果可能），或者重试操作。 仅当用户按下了“切换到”按钮，hTask 为 NULL 且设置了BZ_NOTRESPONDING标志时，OleUIBusy 才会返回OLEUI_BZ_SWITCHTOSELECTED。
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	在 OLEUIBUSY 结构的 hTask 成员中指定的 hTask 无效。

注解

标准 OLE 服务器 忙碌 对话框通知用户服务器应用程序未收到消息。 然后，该对话框要求用户取消操作、切换到被阻止的任务，或继续等待。

注意

oledlg.h 标头将 OLEUIBUSY 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	oledlg.h
Library	OleDlg.lib
DLL	OleDlg.dll

另请参阅

OLEUIBUSY