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) |