cciPropagatedMessageCallback

Hier handelt es sich um eine Funktion, die als Callback registriert werden kann und dann aufgerufen wird, wenn eine Nachricht von einem Knoten an einen anderen übergeben wird. Sie 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 iFpPropagatedMessageCallback-Feld des CCI_UE_VFT-Strukts bereitgestellt wird, das an cciRegisterUserExit übergeben wurde.

Syntax

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

Parameter

userContext (Eingabe)
Dies ist der Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
message
Dies ist eine Kennung für das Nachrichtenobjekt, das weitergegeben wird. Der Benutzerexitcode darf diese Baumstruktur nicht aktualisieren.
localEnvironment
Dies ist eine Kennung für das Objekt der lokalen Umgebung, das weitergegeben wird.
exceptionList
Dies ist eine Kennung für das Ausnahmelistenobjekt, das weitergegeben wird.
environment
Dies ist eine Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Dies ist eine Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Es kann beispielsweise in Aufrufen für cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese Kennung ist nur während dieses Aufrufs 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 | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
as35930_