次の方法で共有

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 を含む)