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