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)