共用方式為


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,則儲存的值會是零。 否則,minidriver 特定錯誤碼會儲存在此參數所指向的位置。

傳回值

成功時,方法應該會傳回 S_OK,並清除 plDevErrVal 所指向的裝置錯誤值。 如果方法失敗,它應該會傳回標準 COM 錯誤碼,並將minidriver特定錯誤碼值放在 plDevErrVal 所指向的記憶體中plDevErrVal 所指向的值可以藉由呼叫 IWiaMiniDrv::d rvGetDeviceErrorStr來轉換成字符串。

言論

為了刪除驅動程式專案,WIA 服務會呼叫 minidriver 方法 IWiaMiniDrv::d rvDeleteItem。 在此方法中,minidriver 會嘗試刪除 WIA 服務內容參數指向的專案,pWiasContext。 如果成功刪除專案,此方法會傳回 S_OK,並將裝置錯誤值參數 plDevErrVal 設為零。 如果發生裝置錯誤,此方法會傳回裝置錯誤值參數中的 E_FAIL 和裝置特定錯誤值,plDevErrVal

在 WIA 服務呼叫此方法之前,它會驗證下列各項:

  • 專案不是根專案。

  • 如果專案是資料夾,則沒有任何子系。

  • 項目的訪問許可權允許刪除。

由於 WIA 服務會驗證這些條件,因此迷你驅動程式不需要也加以驗證。

要求

要求 價值
目標平臺 桌面
標頭 wiamindr_lh.h (包括 Wiamindr.h)

另請參閱

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr