IWiaMiniDrv::d rvDeleteItem-Methode (wiamindr_lh.h)
Die IWiaMiniDrv::d rvDeleteItem Methode löscht das aktuelle Treiberelement.
Syntax
HRESULT drvDeleteItem(
BYTE *__MIDL__IWiaMiniDrv0053,
LONG __MIDL__IWiaMiniDrv0054,
LONG *__MIDL__IWiaMiniDrv0055
);
Parameter
__MIDL__IWiaMiniDrv0053
lFlags [in]
Reserviert.
__MIDL__IWiaMiniDrv0054
pWiasContext- [in]
Zeiger auf einen WIA-Elementkontext.
__MIDL__IWiaMiniDrv0055
plDevErrVal [out]
Verweist auf einen Speicherspeicherort, der einen Statuscode für diese Methode empfängt. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die durch diesen Parameter verwiesen wird.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den durch plDevErrValverwiesen wurde. Wenn die Methode fehlschlägt, sollte ein standardmäßiger COM-Fehlercode zurückgegeben und ein minidriverspezifischer Fehlercodewert im Speicher platziert werden, auf den plDevErrValverweist. Der wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStraufgerufen wird.
Bemerkungen
Um ein Treiberelement zu löschen, ruft der WIA-Dienst die Minidriver-Methode IWiaMiniDrv::d rvDeleteItemauf. In dieser Methode versucht der Minidriver, das element zu löschen, auf das der WIA-Dienstkontextparameter verweist, pWiasContext. Wenn das Element erfolgreich gelöscht wurde, gibt die Methode S_OK zurück und legt den Gerätefehlerwertparameter plDevErrVal auf Null fest. Wenn ein Gerätefehler auftritt, gibt die Methode E_FAIL und einen gerätespezifischen Fehlerwert im Parameter für den Gerätefehlerwert plDevErrValzurück.
Bevor der WIA-Dienst diese Methode aufruft, überprüft er Folgendes:
Das Element ist nicht das Stammelement.
Wenn es sich bei dem Element um einen Ordner handelt, hat es keine untergeordneten Elemente.
Die Zugriffsrechte des Elements ermöglichen das Löschen.
Da der WIA-Dienst diese Bedingungen überprüft, ist es nicht erforderlich, dass der Minidriver sie ebenfalls überprüft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wiamindr_lh.h (include Wiamindr.h) |