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 Diagnoseprotokollmeldung 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 sein.

[in] lResID

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

lDetail

Gibt die Diagnosedetailseebene der Nachricht an. Dieser Parameter kann einen der folgenden Werte annehmen.

Ebene	BESCHREIBUNG
WIALOG_LEVEL1	Protokolliert Ein- und Ausgangspunkte für alle WIA-Methoden und -Funktionen.
WIALOG_LEVEL2	Protokolliert zusätzliche Details für WIALOG_LEVEL1.
WIALOG_LEVEL3	Protokolliert Ein- und Ausgangspunkte für alle WIA-Methoden und -Funktionen sowie 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 sein und die Nachricht im Format "class::method, error-text" generieren.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode fehlschlägt, wird ein COM-Standardfehlercode zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Veraltet und wird nicht mehr unterstützt. Verwenden Sie stattdessen die Diagnoseprotokollmakros.
Zielplattform	Desktop
Kopfzeile	wia_lh.h (einschließlich Wia_lh.h)