cniCreateMessage

新しい出力メッセージ・オブジェクトを作成します。 この関数を呼び出すたびに、 出力メッセージの処理の完了時に割り振られたリソースを戻すために、 対応する cniDeleteMessage の呼び出しがなければなりません。

構文

CciMessage* cniCreateMessage(
  int* returnCode,
  CciMessageContext* messageContext);

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_FAILURE
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_CONTEXT
messageContext
メッセージのコンテキストのアドレス (入力)。 着信メッセージ (例えば cniEvaluate 関数で受け取るメッセージ) からコンテキストを取得するには、 cniGetMessageContext を使用してください。

戻り値

成功した場合、メッセージ・オブジェクトのアドレスが戻されます。 失敗した場合、ゼロの値 (CCI_NULL_ADDR) が戻され、returnCode パラメーターがエラーの理由を示します。

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as07570_