cpiNextParserClassName

Finalidade

Função opcional para retornar o nome da próxima classe de analisador na cadeia, se existir. Permite ao analisador retornar para o intermediário o nome da classe de analisador que manipula a próxima seção, ou o restante, do conteúdo da mensagem. Normalmente, para mensagens que tenham um tipo de formato simples, existe apenas um analisador de conteúdo da mensagem; não é necessário fornecer esta função. Para mensagens que tenham um tipo de formato mais complexo com vários analisadores de mensagem, cada analisador deve identificar o próximo na cadeia retornando seu nome no parâmetro buffer.O último analisador na cadeia deve retornar uma cadeia vazia.

Se você especificar o nome de um analisador fornecido com o WebSphere Message Broker, deverá utilizar o nome de classe correto do analisador.

Definido em Type Membro
CPI_VFT Opcional iFpNextParserClassName

Sintaxe

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

Parâmetros

parser
O endereço do objeto analisador (entrada).
context
O endereço do contexto de propriedade do objeto analisador (entrada).
buffer
O endereço de um buffer no qual o nome da classe de analisador deve ser colocado (entrada).
size
O comprimento, em bytes, do buffer fornecido pelo intermediário (entrada).

Valores de Retorno

Nenhum.

Amostra

Este exemplo foi tirado do arquivo do analisador de amostra BipSampPluginParser.c (linhas 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);
}
  /* Copiar o nome para o intermediário */
CciCharNCpy(buffer, pc->iNextParserClassName, size);
if (pc->trace) {
fprintf(pc->tracefile, "PLUGIN: <- cpiNextParserClassName()\n");
fflush(pc->tracefile);
}
  return;
}
Conceitos relacionados
Analisadores Definidos pelo Usuário
Extensões Definidas pelo Usuário
Tarefas relacionadas
Criando um Analisador em C
Referências relacionadas
cpiNextParserCodedCharSetId
cpiNextParserEncoding
Funções de Implementação do Analisador C
Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as08120_