WebSphere Message Broker Version 8.0.0.5 Betriebssysteme: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Sehen Sie sich die Informationen zur aktuellen Produktversion im IBM Integration Bus Version 9.0 an.

cpiCreateContext

Diese Funktion erstellt einen benutzerdefinierten Erweiterungskontext, der einem Parserobjekt zugeordnet ist. Sie wird vom Broker aufgerufen, wenn eine Instanz eines Parserobjekts erstellt oder zugeordnet wird. Dies ist der Fall, wenn ein Nachrichtenfluss die Auswertung der Nachrichtendaten verursacht; der Broker erstellt ein Parserobjekt oder weist dieses zu, um den entsprechenden Abschnitt der Nachrichtendaten anzufordern.

Bevor diese Funktion aufgerufen wird, erstellt der Broker ein Namenselement als effektives Stammelement für den Parser. Dieses Element ist jedoch nicht benannt. Der Parser muss dieses Element in der Funktion cpiSetElementName benennen.

Die Zuständigkeiten der Erweiterung sind die Folgenden:
  1. Zuordnen aller für die Parserinstanz spezifischen Datenbereiche (wie z. B. Kontext), die möglicherweise angefordert werden.
  2. Durchführen der gesamten zusätzlichen Ressourcenübernahme oder -initialisierung, die möglicherweise erforderlich ist.
  3. Zurückgeben der Adresse des Kontexts zur aufrufenden Funktion. Wenn eine Implementierungsfunktion für diese Parserinstanz aufgerufen wird, wird der entsprechende Kontext als Argument an diese Funktion übergeben. Deshalb muss ein in C entwickelter benutzerdefinierter Parser nicht seine eigenen statischen Zeiger auf instanzspezifische Datenbereiche verwalten.
Definiert in Typ Mitglied
CPI_VFT Obligatorisch iFpCreateContext

Syntax

void cpiCreateContext(
  CciParser*   parser);

Parameter

parser
Die Adresse des Parserobjekts (Eingabe).

Rückgabewerte

Bei Erfolg wird die Adresse des benutzerdefinierten Erweiterungskontexts zurückgegeben. Ansonsten wird ein Nullwert ausgegeben.

Bemerkungen | Marken | Downloads | Bibliothek | Support | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Letzte Aktualisierung:
        
        Letzte Aktualisierung: 2015-02-28 16:22:03


ReferenzthemaReferenzthema | Version 8.0.0.5 | as08095_