変更の始まり

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 then you should resize and retry*/
}
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック
Copyright IBM Corporation 1999, 2006 Last updated: 5 01, 2006
as35930_


変更の終わり