IWiaAppErrorHandler：：ReportStatus 方法
在图像数据传输过程中处理设备状态和错误消息，并向用户显示消息。
语法
HRESULT ReportStatus(
[in] LONG lFlags,
[in] IWiaItem2 *pWiaItem2,
[in] HRESULT hrStatus,
[in] LONG lPercentComplete
);
参数
-
lFlags [in]
-
类型： LONG
未使用。 设置为 0。
-
pWiaItem2 [in]
-
类型： IWiaItem2*
指向要传输的项的指针。
-
hrStatus [in]
-
类型： HRESULT
设备状态代码。
-
lPercentComplete [in]
-
类型： LONG
当前操作已完成的百分比。
返回值
类型： HRESULT
如果无法从错误中恢复，则返回 hrStatus 。 否则，它将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
如果 hrStatus 是错误，则已采取适当的操作来更正错误，并且传输可以继续。 如果 hrStatus 是信息性的，则通过无模式对话框通知用户，并选择不取消传输。 |
|
用户取消了错误处理程序无模式对话框中的传输。 无论 hrStatus 是什么，都可以随时返回此值。 |
|
未采取任何行动：也就是说，未向用户显示任何对话框。 将调用下一个错误处理程序。 错误处理程序的顺序为：应用程序、驱动程序和系统默认值。 |
备注
lPercentComplete 参数允许错误处理程序窗口显示进度。 例如，驱动程序可能会提供“预热”所需时间的估计值。 传递到 IWiaAppErrorHandler：：ReportStatus 的 lPercentComplete 参数与驱动程序设置为 WiaTransferParams 结构的 lPercentComplete 值相同。
错误处理程序可以使用 SUCCEEDED 和 FAILED 宏来查明 hrStatus 是否具有SEVERITY_ERROR或SEVERITY_SUCCESS。
如果 hrStatus 是SEVERITY_SUCCESS，则应允许用户取消转移。
如果 hrStatus 是SEVERITY_ERROR，则错误处理程序应显示应用程序父窗口拥有的模式对话框。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 |
Windows Server 2008 [仅限桌面应用] |
| 标头 |
|
| IDL |
|
| 库 |
|