IWiaLog::Log-Methode (wia_lh.h)

Die IWiaLog::Log-Methode ist veraltet und wird nicht mehr unterstützt. Verwenden Sie stattdessen die Diagnoseprotokollmakros.

Die IWiaLog::Log-Methode schreibt eine Diagnoseprotokollnachricht in Wiaservc.log.

Syntax

HRESULT Log(
  [in] LONG lFlags,
  [in] LONG lResID,
       LONG lDetail,
  [in] BSTR bstrText
);

Parameter

[in] lFlags

Gibt den Typ der Diagnosenachricht an. Dieser Parameter kann WIALOG_TRACE, WIALOG_WARNING oder WIALOG_ERROR werden.

[in] lResID

Gibt die Ressourcen-ID an. Dieser Parameter sollte auf WIALOG_NO_RESOURCE_ID festgelegt werden.

lDetail

Gibt die Diagnosedetailebene der Nachricht an. Dieser Parameter kann einer der folgenden Werte sein:

Niveau	Beschreibung
WIALOG_LEVEL1	Protokolliert Einstiegs- und Ausgangspunkte für alle WIA-Methoden und -Funktionen.
WIALOG_LEVEL2	Protokolliert zusätzliche Details für WIALOG_LEVEL1.
WIALOG_LEVEL3	Protokolliert Einstiegs- und Ausgangspunkte für alle WIA-Methoden und -Funktionen und zusätzliche vom Anbieter bereitgestellte Funktionen.
WIALOG_LEVEL4	Protokolliert zusätzliche Details für WIALOG_LEVEL3.
WIALOG_LEVELXXX	Benutzerdefinierte Protokollebenen.

[in] bstrText

Gibt den Fehlertext an. Dem Fehlertext sollte der vollständige Name der Methode oder Funktion vorangestellt und die Meldung im Format "class::method, error-text" generiert werden.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, wird ein standardmäßiger COM-Fehlercode zurückgegeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Veraltet und wird nicht mehr unterstützt. Verwenden Sie stattdessen die Diagnoseprotokollmakros.
Zielplattform-	Desktop
Header-	wia_lh.h (einschließen Wia_lh.h)