WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

cpiCreateContext

Esta função cria um contexto de extensão definido pelo usuário associado a um objeto analisador. Ela é chamada pelo broker quando uma instância de um objeto analisador é construído ou alocado. Esta ação ocorre quando um fluxo de mensagens faz com que os dados da mensagem sejam analisados; o broker constrói ou aloca um objeto analisador para adquirir a seção apropriada dos dados da mensagem.

Antes desta função ser chamada, o broker cria um elemento de nome como o elemento-raiz efetivo para o analisador. Entretanto, esse elemento não é nomeado. O analisador deve nomear este elemento na função cpiSetElementName.

As responsabilidades da extensão são:
  1. Aloque todas as áreas de dados específicas da instância do analisador (tal como o contexto) que possam ser necessárias.
  2. Execute toda aquisição ou inicialização de recurso adicional que possa ser necessária.
  3. Retornar o endereço do contexto para a função responsável pela chamada. Sempre que uma função de implementação para esta instância do analisador é chamada, o contexto apropriado é transmitido como um argumento para essa função. Portanto, um analisador definido pelo usuário desenvolvido em C não precisa manter seus próprios ponteiros estáticos para áreas de dados por instância.
Definido em Tipo Membro
CPI_VFT Obrigatório iFpCreateContext

Sintaxe

void cpiCreateContext(
  CciParser*  parser);

Parâmetros

parser
O endereço do objeto analisador (entrada).

Valores de Retorno

Se for bem-sucedido, o endereço do contexto da extensão definida pelo usuário será retornado. Caso contrário, um valor de zero é retornado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:30:24


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | as08095_