IWiaMiniDrv::d rvGetDeviceErrorStr 方法 (wiamindr_lh.h)

IWiaMiniDrv::d rvGetDeviceErrorStr 方法将错误代码映射到描述错误的 Unicode 字符串。

语法

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

参数

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

指定要映射到字符串的设备错误值。 值为零表示未发生任何错误。

__MIDL__IWiaMiniDrv0040

lFlags [in]

保留。

__MIDL__IWiaMiniDrv0041

plDevErr [out]

指向将接收此方法的状态代码的内存位置。 如果此方法返回 S_OK,则存储的值将为零。 否则,微型驱动程序特定的错误代码将存储在此参数指向的位置。

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

指向将接收描述错误的字符串地址的内存位置。

返回值

成功后,该方法应返回 S_OK 并清除 plDevErr 指向的设备错误值。 如果微型驱动程序未完全实现此方法,该方法应返回 E_NOTIMPL。 如果微型驱动程序无法识别传递给此方法的错误值,该方法应返回 E_INVALIDARG。 如果方法失败,它应返回标准 COM 错误代码,并将特定于微型驱动程序的错误代码值放在 plDevErr 指向的内存中。

注解

为了获取描述特定于设备的微型驱动程序生成的错误值的错误字符串,WIA 服务调用 IWiaMiniDrv::d rvGetDeviceErrorStr 方法。 为了响应此调用,微型驱动程序应使用 CoTaskMemAlloc 分配将包含对应于传递给微型驱动程序的错误代码的本地化 Unicode 字符串的内存。 WIA 服务 (或应用程序) 将释放内存。 应用程序可能会显示字符串,因此它应该对最终用户有意义。 应从资源文件加载字符串,以便可以本地化为多种语言。

要求

要求
目标平台 桌面
标头 wiamindr_lh.h (包括 Wiamindr.h)