cciLog

エラー、警告、または通知イベントをログに記録します。 イベントは、ログ・データとして指定される引数を使用して、 メッセージ・ブローカー・インターフェースによってログ記録されます。

構文

void cciLog(
  int* returnCode,
  CCI_LOG_TYPE type,
  char* file,
  int line,
  char* function,
  CciChar* messageSource,
  int messageNumber,
  char* traceText,
                ...);

パラメーター

returnCode
関数からの戻りコード (出力)。考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_INV_DATA_POINTER
  • CCI_INV_LOG_TYPE
type
CCI_LOG_TYPE で定義されるイベントのタイプ (入力)。 有効な値は以下のとおりです。
  • CCI_LOG_ERROR
  • CCI_LOG_WARNING
  • CCI_LOG_INFORMATION
file
関数が呼び出されたソース・ファイル名 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
line
関数が呼び出されたソース・ファイルでの行番号 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
function
ログ関数を呼び出した関数名 (入力)。 この値はオプションですが、デバッグ目的に役立てることができます。
messageSource
Windows メッセージ・ソースまたは Linux および UNIX メッセージ・カタログを識別するストリング。
messageNumber
イベントを識別するメッセージ番号 (入力)。 messageNumber にゼロが指定されている場合、メッセージが利用不能であると想定します。 messageNumber がゼロでない場合、 指定したメッセージがブローカー・イベント・ログに書き込まれ、 変数引数リストに任意の挿入が提供されます (下を参照)。
traceText
ブローカー・サービス・トレース・ログに書き込まれるトレース情報 (入力)。 この情報はオプションですが、デバッグ目的に役立てることができます。
...
メッセージに付随する任意のメッセージ挿入を含む C 変数引数リスト (入力)。 これらの挿入は文字ストリングとして扱われ、 変数引数はタイプが pointer to char (文字へのポインター) であると見なされます。
注: char* 文字は、ASCII (Latin) または EBCDIC (1047) のストリングでなければなりません。
注: このリストの最後の引数は、(char*)0 でなければなりません

戻り値

なし。 エラーが発生した場合、returnCode パラメーターがエラーの理由を示します。

特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as08552_