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

IWiaMiniDrv::d rvDeleteItem 方法删除当前驱动程序项。

语法

HRESULT drvDeleteItem(
  BYTE *__MIDL__IWiaMiniDrv0053,
  LONG __MIDL__IWiaMiniDrv0054,
  LONG *__MIDL__IWiaMiniDrv0055
);

参数

__MIDL__IWiaMiniDrv0053

lFlags [in]

保留。

__MIDL__IWiaMiniDrv0054

pWiasContext [in]

指向 WIA 项上下文的指针。

__MIDL__IWiaMiniDrv0055

plDevErrVal [out]

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

返回值

成功后,方法应返回 S_OK 并清除 plDevErrVal 指向的设备错误值。 如果方法失败,它应返回标准 COM 错误代码,并在 plDevErrVal 指向的内存中放置一个特定于微型驱动程序的错误代码值。 plDevErrVal 指向的值可以通过调用 IWiaMiniDrv::d rvGetDeviceErrorStr 转换为字符串。

注解

为了删除驱动程序项,WIA 服务将调用 minidriver 方法 IWiaMiniDrv::d rvDeleteItem。 在此方法中,微型驱动程序将尝试删除 WIA 服务上下文参数 pWiasContext 指向的项目。 如果成功删除该项,该方法将返回 S_OK 并将设备错误值参数 plDevErrVal 设置为零。 如果发生设备错误,该方法在设备错误值参数 plDevErrVal 中返回E_FAIL和设备特定的错误值。

在 WIA 服务调用此方法之前,它会验证以下内容:

  • 该项不是根项。

  • 如果项是文件夹,则它没有任何子项。

  • 项的访问权限允许删除。

由于 WIA 服务会验证这些条件,因此微型驱动程序无需也对其进行验证。

要求

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

另请参阅

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr