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 diese Baumstruktur nicht aktualisieren.
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, sollten Sie die Größe ändern und es erneut versuchen*/

}
Zugehörige Konzepte
Benutzerexits
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Letzte Aktualisierung : 2009-02-17 15:30:03

as35930_