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, 2005 Last updated: 11/07/2005
as07570_