cpiCreateContext

Zweck

Erstellt einen benutzerdefinierten Erweiterungskontext, der einem Parserobjekt zugeordnet ist. Die Funktion wird vom Nachrichtenbroker 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, wird der Broker ein Namenelement als effektives Stammelement für den Parser erstellt haben. Dieses Element ist jedoch nicht benannt. Der Parser sollte dieses Element in der Funktion cpiSetElementName benennen.

Die Zuständigkeiten der Erweiterung sind die Folgenden:
  1. Parserinstanz-spezifische Datenbereiche (wie z. B. Kontext) zuordnen, die möglicherweise angefordert werden.
  2. Durchführen zusätzlicher Ressourcenübernahme oder -initialisierung, die möglicherweise erforderlich sind.
  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. Dies bedeutet, dass ein in C entwickelter benutzerdefinierter Parser nicht seine eigenen statischen Zeiger auf instanzspezifische Datenbereiche verwalten muss.
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.

Zugehörige Konzepte
Benutzerdefinierte Parser
Benutzerdefinierte Erweiterungen
Zugehörige Verweise
C-Parser-Implementierungsfunktionen
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as08095_