IStillImageW::WriteToErrorLog 方法 (sti.h)

IStillImage::WriteToErrorLog 方法将消息写入静止图像错误日志。

语法

HRESULT WriteToErrorLog(
       DWORD   dwMessageType,
  [in] LPCWSTR pszMessage
);

参数

dwMessageType

表示消息类型的调用方提供的常量值。 Sti.h中定义了以下值:

STI_TRACE_INFORMATION

STI_TRACE_WARNING

STI_TRACE_ERROR

[in] pszMessage

调用方提供的指向要写入日志文件的消息字符串的指针。

返回值

如果作成功,该方法将返回S_OK。 否则,它将返回在 stierr.h中定义的 STIERR 前缀错误代码之一。

言论

静止图像错误日志文件命名为 sti_trace.log,位于 Windows 目录中。 注册表值确定将哪些仍映像错误类型(信息性、警告或错误)写入错误日志(请参阅 不可修改的注册表项)。

应为严重错误条件(例如设备硬件故障)保留错误消息。 信息性消息可用于你自己的调试目的。 记录的消息对用户不可见,但支持工程师可能会使用它们来帮助调试用户的问题。

在调用 IStillImage::WriteToErrorLog之前,IStillImage COM 接口的客户端必须调用 IStillImage::StiCreateInstance 以获取 IStillImage 接口指针。

要求

要求 价值
目标平台 桌面
标头 sti.h (include Sti.h)