OleUIBusyW 函数 (oledlg.h)

调用标准 忙碌 对话框,允许用户管理并发。

语法

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
OLEUIBUSY 结构的 hTask 成员中指定的 hTask 无效。

言论

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

注意

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

要求

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

另请参阅

OLEUIBUSY