共用方式為


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 設定為零。 如果發生裝置錯誤,方法會傳回裝置錯誤值參數 plDevErrVal 中的E_FAIL和裝置特定的錯誤值。

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

  • 專案不是根專案。

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

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

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

規格需求

需求
目標平台 桌面
標頭 wiamindr_lh.h (包括 Wiamindr.h)

另請參閱

IWiaMiniDrv

IWiaMiniDrv::d rvGetDeviceErrorStr