通过

IWiaErrorHandler：：GetStatusDescription 方法 （wia_lh.h）

  • 项目

系统 UI 调用 GetStatusDescription 方法，以向用户提供有关错误的额外信息（如果用户请求此信息）。 此方法由驱动程序的 UI 扩展实现。

语法

HRESULT GetStatusDescription(
  [in]  LONG      lFlags,
  [in]  IWiaItem2 *pWiaItem2,
  [in]  HRESULT   hrStatus,
  [out] BSTR      *pbstrDescription
);

参数

[in] lFlags

当前未使用。 应设置为零。

[in] pWiaItem2

指向正在传输的 IWiaItem2 项的指针。

[in] hrStatus

包含 WIA 传输方法接收的状态代码的 HRESULT 变量，例如 IWiaDataCallback：：BandedDataCallback。

[out] pbstrDescription

指向 BSTR 的指针，该 BSTR 接收传输期间遇到的状态或错误的说明。 此参数不能 NULL。 驱动程序必须使用 SysAllocString 函数分配字符串，调用方必须使用 SysFreeString]（/windows/win32/api/oleauto/nf-oleauto-sysfreestring）函数释放字符串。

返回值

如果发生错误，则返回标准 COM 错误代码，或者返回以下代码之一：

返回代码 描述
S_OK pbstrDescription 参数包含有效的 BSTR 指针。
WIA_STATUS_NOT_HANDLED hrStatus 参数中的值对扩展未知，并且没有可用的说明。

言论

为了使应用程序调用 IWiaErrorHandler：：GetStatusDescription，应用程序必须首先调用 IWiaItem2：：GetExtension 才能接收指向错误处理扩展的接口指针。 应用程序必须将“ErrorHandler”作为 bstrName 传递，IID_IWiaErrorHandler作为 riidExtensionInterface 传递。 应用程序应将 0 作为 lFlag 传递，以确保向上兼容性。

IWiaErrorHandler：：GetStatusDescription 的实现应为所有设备状态代码（hrStatus）返回S_OK，IWiaErrorHandler：：ReportStatus 句柄的实现 WIA_STATUS_NOT_HANDLED，对于 IWiaErrorHandler：：ReportStatus 的实现，

要求

要求 价值
目标平台 桌面
标头 wia_lh.h （包括 Wia_lh.h）

另请参阅

IWiaErrorHandler

IWiaErrorHandler：：ReportStatus