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 (包含 Sti.h)