Metodo IWiaMiniDrv::d rvDeleteItem (wiamindr_lh.h)
Il metodo IWiaMiniDrv::d rvDeleteItem elimina l'elemento driver corrente.
Sintassi
HRESULT drvDeleteItem(
BYTE *__MIDL__IWiaMiniDrv0053,
LONG __MIDL__IWiaMiniDrv0054,
LONG *__MIDL__IWiaMiniDrv0055
);
Parametri
__MIDL__IWiaMiniDrv0053
lFlags [in]
Riservato.
__MIDL__IWiaMiniDrv0054
pWiasContext [in]
Puntatore a un contesto di elemento WIA.
__MIDL__IWiaMiniDrv0055
plDevErrVal [out]
Punta a una posizione di memoria che riceverà un codice di stato per questo metodo. Se questo metodo restituisce S_OK, il valore archiviato sarà zero. In caso contrario, un codice di errore specifico del minidriver verrà archiviato nella posizione a cui punta questo parametro.
Valore restituito
In caso di esito positivo, il metodo deve restituire S_OK e cancellare il valore di errore del dispositivo a cui punta plDevErrVal. Se il metodo ha esito negativo, deve restituire un codice di errore COM standard e inserire un valore di codice di errore specifico del minidriver nella memoria a cui punta plDevErrVal. Il valore a cui punta plDevErrVal può essere convertito in una stringa chiamando IWiaMiniDrv::d rvGetDeviceErrorStr.
Commenti
Per eliminare un elemento driver, il servizio WIA chiamerà il metodo minidriver IWiaMiniDrv::d rvDeleteItem. In questo metodo, il minidriver tenterà di eliminare l'elemento a cui punta il parametro di contesto del servizio WIA pWiasContext. Se l'elemento viene eliminato correttamente, il metodo restituisce S_OK e imposta il parametro del valore di errore del dispositivo plDevErrVal su zero. Se si verifica un errore del dispositivo, il metodo restituisce E_FAIL e un valore di errore specifico del dispositivo nel parametro del valore di errore del dispositivo plDevErrVal.
Prima che il servizio WIA chiami questo metodo, verifica quanto segue:
L'elemento non è l'elemento radice.
Se l'elemento è una cartella, non ha elementi figlio.
I diritti di accesso dell'elemento consentono l'eliminazione.
Poiché il servizio WIA verifica queste condizioni, non è necessario che anche il minidriver li verifichi.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | wiamindr_lh.h (include Wiamindr.h) |