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

指定资源 ID。此参数应设置为 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 错误代码。