cpiNextParserClassName

Scopo

Funzione facoltativa che restituisce il nome di classe del programma di analisi successivo nella catena, se presente. Consente al programma di analisi di restituire al broker il nome di classe del programma di analisi che gestisce la sezione successiva, o rimanente del contenuto del messaggio. Di solito, per messaggi che hanno un tipo di formato semplice, esiste un unico programma di analisi del contenuto del messaggio; non è necessario fornire questa funzione. Relativamente a messaggi che hanno un tipo di formato più complesso con più programmi di analisi di messaggi, ciascun programma deve identificare il successivo nella catena restituendone il nome nel parametro buffer. L'ultimo programma di analisi nella catena deve restituire una stringa vuota.

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 iFpNextParserClassName

Sintassi

void cpiNextParserClassName(
  CciParser*  parser,
  CciContext*  context,
  CciChar*     buffer,
  int          size);

Parametri

parser
L'indirizzo dell'oggetto programma di analisi (input).
context
L'indirizzo del contesto che l'oggetto programma di analisi possiede (input).
buffer
L'indirizzo di un buffer in cui deve essere inserito il nome di classe del programma di analisi (input).
size
La lunghezza, in byte, del buffer fornito dal broker (input).

Valori di restituzione

Nessuno.

Esempio

Questo esempio è estratto dal file del programma di analisi di esempio BipSampPluginParser.c (da riga 732 a 756).

void cpiNextParserClassName(
  CciParser*  parser,
  CciContext*  context,
  CciChar*     buffer,
  int         size
){
  PARSER_CONTEXT_ST* pc = (PARSER_CONTEXT_ST *)context ;
  int                  rc = 0;

  if (pc->trace) {
    fprintf(pc->tracefile, "PLUGIN: -> cpiNextParserClassName() parser=0x%x context=0x%x\n",
            parser, context);
    fflush(pc->tracefile);
  }

  /* Copia il nome nel broker */
  CciCharNCpy(buffer, pc->iNextParserClassName, size);

  if (pc->trace) {
    fprintf(pc->tracefile, "PLUGIN: <- cpiNextParserClassName()\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
cpiNextParserCodedCharSetId
cpiNextParserEncoding
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
as08120_