cciPropagatedMessageCallback

Hierbei handelt es sich um eine Funktion, die als Callback registriert werden kann und aufgerufen wird, sobald eine Nachricht von einem Knoten an einen anderen weitergegeben wird. Wenn der Benutzerexitstatus aktiv ist, wird sie für jede Nachricht aufgerufen, die innerhalb der Ausführungsgruppe weitergegeben wird, in der der Callback registriert wurde. Der Callback wird durch die Bereitstellung eines Zeigers auf die Funktion als Feld iFpPropagatedMessageCallback des CCI_UE_VFT-Structs registriert, das an cciRegisterUserExit übergeben wird.

Syntax

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

Parameter

userContext (Eingabe)
Hierbei handelt es sich um einen Wert, der an die Funktion cciRegisterUserExit übergeben wurde.
message
Dies ist eine interne Kennung für das weitergegebene Nachrichtenobjekt. Der Benutzerexitcode darf diese Baumstruktur nicht aktualisieren.
localEnvironment
Dies ist eine interne Kennung für das weitergegebene Objekt der lokalen Umgebung.
exceptionList
Dies ist eine interne Kennung für das weitergegebene Ausnahmelistenobjekt.
environment
Dies ist eine interne Kennung für das Umgebungsobjekt für den aktuellen Nachrichtenfluss.
connection
Die interne Kennung für das Verbindungsobjekt zwischen den beiden Knoten. Sie kann beispielsweise in Aufrufen von cciGetSourceNode, cciGetTargetNode, cciGetSourceTerminalName und cciGetTargetTerminalName verwendet werden. Diese interne Kennung ist nur für die Dauer 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);
   /*Sie sollten jetzt den RC auf unerwartete Werte prüfen*/
   /*Wenn der RC CCI_BUFFER_TOO_SMALL ist, sollten Sie die Größe ändern und den Versuch wiederholen*/
}
Zugehörige Konzepte
Benutzerexits entwickeln
Zugehörige Tasks
Benutzerexit entwickeln
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as35930_