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 status Code für diese Methode erhält. Wenn diese Methode S_OK zurückgibt, ist der gespeicherte Wert null. Andernfalls wird ein minidriverspezifischer Fehlercode an der Stelle gespeichert, auf die dieser Parameter verweist.
Rückgabewert
Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den plDevErrVal verweist. Wenn die Methode fehlschlägt, sollte sie einen standardmäßigen COM-Fehlercode zurückgeben und einen minidriver-spezifischen Fehlercodewert im Speicher platzieren, auf den plDevErrVal verweist. Der Wert, auf den plDevErrVal verweist, kann in eine Zeichenfolge konvertiert werden, indem IWiaMiniDrv::d rvGetDeviceErrorStr aufgerufen wird.
Hinweise
Um ein Treiberelement zu löschen, ruft der WIA-Dienst die minidriver-Methode IWiaMiniDrv::d rvDeleteItem auf. In dieser Methode versucht der Minidriver, das Element zu löschen, auf das der KONTEXTparameter des WIA-Diensts pWiasContext verweist. 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 Gerätefehlerwertparameter plDevErrVal zurü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, verfügt es über keine untergeordneten Elemente.
Die Zugriffsrechte des Elements lassen das Löschen zu.
Da der WIA-Dienst diese Bedingungen überprüft, ist es nicht erforderlich, dass der Minitreiber sie ebenfalls überprüft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | wiamindr_lh.h (wiamindr.h einschließen) |