cpiCreateContext

Zweck

Diese Funktion erstellt einen benutzerdefinierten Erweiterungskontext, der einem Parserobjekt zugeordnet ist. Sie wird vom Nachrichtenbroker aufgerufen, wenn eine Instanz eines Parserobjekts erstellt oder zugeordnet wird. Dies ist der Fall, wenn ein Nachrichtenfluss veranlasst, dass die Nachrichtendaten analysiert werden sollen; der Broker erstellt ein Parserobjekt oder ordnet es zu, um den entsprechenden Abschnitt der Nachrichtendaten anzufordern. Bevor diese Funktion aufgerufen wird, hat der Broker ein Namenselement als effektives Stammelement für den Parser erstellt. Dieses Element ist jedoch nicht benannt. Der Parser sollte dieses Element in der Funktion cpiSetElementName benennen.

Die Erweiterung ist für Folgendes zuständig:
  1. Zuordnung von für Parser-Instanzen spezifischen Datenbereiche (z. B. Kontext), die möglicherweise erforderlich sind.
  2. Ausführung einer zusätzlichen Ressourcenübernahme oder Initialisierung, die möglicherweise erforderlich ist.
  3. Rückgabe der Adresse des Kontextes an die aufrufende 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 erfolgreicher Ausführung wird die Adresse des benutzerdefinierten Erweiterungskontextes zurückgegeben. Andernfalls wird der Wert null zurückgegeben.

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: 18.05.2006
as08095_