cciPropagatedMessageCallback

Die Funktion 'cciPropagatedMessageCallback' kann als Callback registriert werden und wird dann aufgerufen, wenn eine Nachricht von einem Knoten an einen anderen übergeben wird.

Die Funktion 'cciPropagatedMessageCallback' wird für jede Nachricht aufgerufen, die innerhalb der Ausführungsgruppe, in welcher der Callback registriert wurde, weitergegeben wird, wenn der Benutzerexitstatus aktiv ist. Der Callback wird registriert, indem ein Zeiger auf die Funktion als Feld iFpPropagatedMessageCallback des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wird.

Syntax

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

Parameter

userContext (Eingabe)
Der Wert, der an die Funktion cciRegisterUserExit übergeben wird.
message
Eine Kennung für das weitergegebene Nachrichtenobjekt. Der Benutzerexitcode darf die Transportheader oder Eigenschaftenelemente in dieser Baumstruktur nicht aktualisieren. Durch eine Aktualisierung der Nachricht kann die Leistung beeinträchtigt werden. Dies gilt insbesondere, wenn die Eingabenachricht im Nachrichtenfluss ansonsten nicht geändert werden würde.
localEnvironment
Eine Kennung für das weitergegebene lokale Umgebungsobjekt.
exceptionList
Eine Kennung für das weitergegebene Ausnahmelistenobjekt.
environment
Eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Eine Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Sie kann beispielsweise bei Aufrufen von cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese Kennung ist nur für die Dauer dieser Instanz der Benutzerexitfunktion gültig.

Rückgabewerte

Keine.

Beispiel

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);
   /*rc sollte nun auf unerwartete Werte überprüft werden*/
   /*wenn rc 'CCI_BUFFER_TOO_SMALL' ist, ändern Sie die Größe versuchen Sie es erneut*/

}
Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2013Copyright IBM Corporation 1999, 2013.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2013-07-18 03:06:24


ReferenzthemaReferenzthema | IBM Integration Bus Version 9.0.0.0 | as35930_