cniCreateMessage

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

構文

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

パラメーター

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

戻り値

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

  outMsg = cniCreateMessage(&rc, cniGetMessageContext(&rc, message));

関連概念
ユーザー定義の入力ノード
ユーザー定義のメッセージ処理ノード
ユーザー定義の出力ノード

関連タスク
C での入力ノードの作成
C でのメッセージ処理ノードの作成

関連資料
C 言語ノード・ユーティリティー関数
cniDeleteMessage
cniEvaluate
cniFinalize
cniGetEnvironmentMessage
cniGetMessageContext
cniPropagate