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 Last updated: 5 01, 2006
as07620_