cniPropagate

指定したターミナル・オブジェクトにメッセージを伝搬します。 ターミナルがコネクターによって他のノードに付加されていない場合には、 メッセージは伝搬されず、この関数はノーオペレーションと見なされます。 したがって、ノードが取るアクションが異ならない限り (この場合は、cniIsTerminalAttached を使用してターミナルが接続されているかを検査する)、 メッセージの伝搬の前にターミナルが付加されているかどうかを検査する必要はありません。

構文

int cniPropagate(
  int* returnCode,
  CciTerminal* terminalObject,
  CciMessage* destinationList,
  CciMessage* exceptionList,
  CciMessage* message);

パラメーター

returnCode
関数からの戻りコード (出力)。
考えられる戻りコードは以下のとおりです。
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
  • CCI_INV_MESSAGE_OBJECT
terminalObject
メッセージを受け取る出力ターミナルのアドレス (入力)。 このアドレスは、cniCreateOutputTerminal によって戻されます。
destinationList
メッセージと共に送信される宛先リスト・オブジェクトのアドレス (入力)。

このメッセージ・オブジェクトは、 メッセージ・ブローカーによって提供されるパブリッシュ/サブスクライブ・ノードによって使用されます。

exceptionList
メッセージの例外リストのアドレス (入力)。
message
送信するメッセージ・オブジェクトのアドレス (入力)。 送信されるメッセージが入力メッセージと同じ場合には、 このアドレスが、cniEvaluate インプリメンテーション関数に渡されるものになります。

戻り値

成功した場合、CCI_SUCCESS が戻されます。 失敗した場合、CCI_FAILURE が戻され、returnCode パラメーターがエラーの理由を示します。

  if (terminalObject) {
    if (cniIsTerminalAttached(&rc, terminalObject)) {
      if (rc == CCI_SUCCESS) {
        cniPropagate(&rc, terminalObject, destinationList, exceptionList, message);
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 最終更新: 08/21/2006
as07620_