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) |