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