cpiSetNextParserClassName

Scopo

Funzione facoltativa per informare un programma di analisi del successivo programma di analisi nella catena. Viene richiamata durante l'elaborazione di finalizzazione e restituisce al programma di analisi definito dall'utente una stringa contenente il nome di classe del programma di analisi successivo nella catena. Consente ad un programma di analisi di prendere parte durante la fase di finalizzazione per modificare la struttura ad albero dell'elemento di sintassi prima della fase che provoca la serializzazione del flusso di bit.

Se si specifica il nome di un programma di analisi fornito con WebSphere Message Broker, è necessario utilizzare l'esatto nome di classe del programma di analisi.

Definito in Tipo Membro
CPI_VFT Facoltativo iFpSetNextParserClassName

Sintassi

void cpiSetNextParserClassName(
  CciParser*  parser,
  CciContext*  context,
  CciChar*     name,
  CciBool      parserType);
 

Parametri

parser
L'indirizzo dell'oggetto programma di analisi (input).
context
L'indirizzo del contesto che l'oggetto programma di analisi possiede (input).
name
Il nome del successivo programma di analisi come una stringa di caratteri CciChar.
parserType
Indica se il programma di analisi a cui si fa riferimento è standard (parserType=0) o non standard (parserType=non-zero) (input). Un programma di analisi standard prevede che il campo Format dell'intestazione precedente nella catena contenga il nome della classe del programma di analisi che segue. Programmi di analisi non standard prevedono che il campo Domain contenga il nome di classe del programma di analisi.

Valori di restituzione

Nessuno.

Esempio

Questo esempio è estratto dal file del programma di analisi di esempio BipSampPluginParser.c (da riga 763 a 787):

void cpiSetNextParserClassName(
  CciParser*  parser,
  CciContext*  context,
  CciChar*     name,
  CciBool     isHeaderParser
){
  PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
  int                  rc = 0;

  /* Salva il nome nel contesto in uso */
  CciCharNCpy(pc->iNextParserClassName, name, CciCharLen(name));

  if (pc->trace) {
    fprintf(pc->tracefile, "PLUGIN: <- cpiSetNextParserClassName()\n");
    fflush(pc->tracefile);
  }

  return;
}
Concetti correlati
Programmi di analisi definiti dall'utente
Estensioni definite dall'utente
Attività correlate
Creazione di un programma di analisi in C
Riferimenti correlati
Funzioni di implementazione del programma di analisi in C
Informazioni particolari | Marchi | Download | Libreria | Supporto | Commenti
Copyright IBM Corporation 1999, 2006 Ultimo aggiornamento: ago 17, 2006
as08200_