IWiaErrorHandler：：ReportStatus 方法

处理图像数据传输期间的状态和错误消息，并向用户显示它们。

语法

HRESULT ReportStatus(
  [in] HWND     hwndParent,
  [in] IUnknown *punkItem,
  [in] HRESULT  hrStatus,
  [in] LONG     cbResLength,
  [in] BYTE     *pbData
);

参数

hwndParent [in]

类型：HWND

HWND ，它是消息窗口的父窗口。

punkItem [in]

类型： IUnknown*

指向要传输的项的 IUnknown 接口的指针。 此对象至少实现 IWiaItem2 和 IWiaDataTransfer。

hrStatus [in]

类型： HRESULT

BandedDataCallback 接收的状态代码的 HRESULT。

cbResLength [in]

类型： LONG

LONG ，即 pbData 引用的数据的大小。

pbData [in]

类型： BYTE*

指向 BandedDataCallback 接收的数据缓冲区的指针。

返回值

类型： HRESULT

如果无法从中恢复错误，则返回 hrStatus 。 否则，它将返回以下值之一。

返回代码	说明
S_OK	已采取适当的操作来更正错误，传输可以继续。
S_FALSE	未执行任何操作来处理错误或向用户报告状态。
E_ABORT	用户选择中止传输以响应显示的对话框。

 

备注

Windows 映像获取 (WIA) 2.0 在驱动程序将IT_MSG_DEVICE_STATUS消息发送到 BandedDataCallback 时调用 IWiaErrorHandler：：ReportStatus。 此方法处理消息，并向用户显示有关状态或错误的信息。 如果消息与错误有关，方法允许用户选择（如果可能）尝试从错误中恢复并继续传输还是中止。

hrStatus 设置为 WIA_STATUS_TRANSFER_BEGIN 以通知处理程序传输已开始。 传输完成后，它设置为WIA_STATUS_TRANSFER_END。

如果 hrStatus 是SEVERITY_SUCCESS，则应允许用户取消转移。

要求

要求	值
最低受支持的客户端	Windows Vista [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 [仅限桌面应用]
标头	Wia.h
IDL	Wia.idl
库	Wiaguid.lib