IWiaLog：：Log 方法（wia_lh.h）

IWiaLog：：Log 方法已過時，不再受到支援。請改用 診斷記錄巨集。

IWiaLog：：Log 方法會將診斷記錄訊息寫入至 Wiaservc.log。

語法

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

[in] lFlags

指定診斷訊息的類型。這個參數可以是WIALOG_TRACE、WIALOG_WARNING或WIALOG_ERROR。

[in] lResID

指定資源識別碼。此參數應設定為 WIALOG_NO_RESOURCE_ID。

lDetail

指定訊息的診斷詳細數據層級。此參數可以是下列其中一個值。

水準	描述
WIALOG_LEVEL1	記錄所有 WIA 方法和函式的進入和結束點。
WIALOG_LEVEL2	記錄WIALOG_LEVEL1的其他詳細數據。
WIALOG_LEVEL3	記錄所有 WIA 方法和函式和其他廠商提供的函式的進入和結束點。
WIALOG_LEVEL4	記錄WIALOG_LEVEL3的其他詳細數據。
WIALOG_LEVELXXX	用戶定義的記錄層級。

[in] bstrText

指定錯誤文字。錯誤文字前面應該加上方法或函式的完整名稱，並以「class：：method， error-text」格式產生訊息。

如果方法成功，則會傳回S_OK。如果方法失敗，則會傳回標準 COM 錯誤碼。