WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

cciPropagatedMessageCallback

cciPropagatedMessageCallback 関数は、コールバックとして登録することができ、あるノードから別のノードにメッセージが伝搬されるたびに呼び出されます。

cciPropagatedMessageCallback 関数は、ユーザー出口の状態がアクティブの場合、コールバックが登録された実行グループ内で伝搬されるメッセージごとに呼び出されます。 コールバックを登録するには、この関数へのポインターを cciRegisterUserExit に渡される CCI_UE_VFT 構造の iFpPropagatedMessageCallback フィールドに指定します。

構文

typedef void (*cciPropagatedMessageCallback)( 
                                 CciDataContext* userContext,
                                 CciMessage*     message,
                                 CciMessage*     localEnvironment,
                                 CciMessage*     exceptionList,
                                 CciMessage*     environment,
                                 CciConnection*  connection);

パラメーター

userContext (入力)
cciRegisterUserExit 関数に渡された値。
message
伝搬されるメッセージ・オブジェクトへのハンドル。 ユーザー出口コードは、このツリー内のトランスポート・ヘッダーまたはプロパティー・エレメントを更新してはなりません。 メッセージを更新すると、それ以外の方法ではメッセージ・フロー内の入力メッセージが変更されない場合には特に、パフォーマンスに影響を与えることがあります。
localEnvironment
伝搬されるローカル環境オブジェクトへのハンドル。
exceptionList
伝搬される例外リスト・オブジェクトへのハンドル。
environment
現行メッセージ・フローの環境オブジェクトへのハンドル。
connection
2 つのノード間の接続オブジェクトへのハンドル。 ハンドルは、例えば、 cciGetSourceNodecciGetTargetNodecciGetSourceTerminalName、 および cciGetTargetTerminalName への呼び出しで使用できます。 このハンドルは、ユーザー出口関数のこのインスタンスの期間内のみ有効です。

戻り値

なし。

void myPropagatedMessageCallback(
                        CciMessage*    message,
                        CciMessage*    localEnvironment,
                        CciMessage*    exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 

   int rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(amp rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(amp rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*you should now check the rc for unexpected values*/
   /*if rc is CCI_BUFFER_TOO_SMALL, resize and retry*/

}
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:48:12


参照トピック参照トピック | バージョン 8.0.0.5 | as35930_