IWiaMiniDrv::d rvGetDeviceErrorStr-Methode (wiamindr_lh.h)

Die IWiaMiniDrv::d rvGetDeviceErrorStr-Methode ordnet einen Fehlercode einer Unicode-Zeichenfolge zu, die den Fehler beschreibt.

Syntax

HRESULT drvGetDeviceErrorStr(
  LONG     __MIDL__IWiaMiniDrv0039,
  LONG     __MIDL__IWiaMiniDrv0040,
  LPOLESTR *__MIDL__IWiaMiniDrv0041,
  LONG     *__MIDL__IWiaMiniDrv0042
);

Parameter

__MIDL__IWiaMiniDrv0039

lDevErrVal [in]

Gibt den Gerätefehlerwert an, der einer Zeichenfolge zugeordnet werden soll. Der Wert 0 gibt an, dass kein Fehler aufgetreten ist.

__MIDL__IWiaMiniDrv0040

lFlags [in]

Reserviert.

__MIDL__IWiaMiniDrv0041

plDevErr [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 0. Andernfalls wird ein minidriverspezifischer Fehlercode an der Position gespeichert, auf die dieser Parameter verweist.

__MIDL__IWiaMiniDrv0042

ppszDevErrStr [out, optional]

Zeigt auf einen Speicherspeicherort, der die Adresse einer Zeichenfolge erhält, die den Fehler beschreibt.

Rückgabewert

Bei Erfolg sollte die Methode S_OK zurückgeben und den Gerätefehlerwert löschen, auf den von plDevErr verwiesen wird. Wenn der Minitreiber diese Methode nicht vollständig implementiert, sollte die Methode E_NOTIMPL zurückgeben. Wenn der Minitreiber den an diese Methode übergebenen Fehlerwert nicht erkennt, sollte die Methode E_INVALIDARG zurückgeben. Wenn die Methode fehlschlägt, sollte sie einen COM-Standardfehlercode zurückgeben und einen minidriver-spezifischen Fehlercodewert im Speicher platzieren, auf den von plDevErr verwiesen wird.

Hinweise

Um eine Fehlerzeichenfolge abzurufen, die einen gerätespezifischen minidriver-generierten Fehlerwert beschreibt, ruft der WIA-Dienst die IWiaMiniDrv::d rvGetDeviceErrorStr-Methode auf. Als Reaktion auf diesen Aufruf sollte der Minidriver CoTaskMemAlloc verwenden, um Arbeitsspeicher zuzuweisen, der eine lokalisierte Unicode-Zeichenfolge enthält, die dem Fehlercode entspricht, der an den Minidriver übergeben wird. Der WIA-Dienst (oder eine Anwendung) gibt den Arbeitsspeicher frei. Es ist wahrscheinlich, dass eine Anwendung die Zeichenfolge anzeigt, daher sollte sie für einen Endbenutzer von Bedeutung sein. Die Zeichenfolge sollte aus einer Ressourcendatei geladen werden, damit sie in eine Vielzahl von Sprachen lokalisiert werden kann.

Anforderungen