Freigeben über


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)