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

cniCreateElementAsLastChildUsingParser

Use esta função para criar um elemento da sintaxe como o último filho do elemento da sintaxe especificado e associe-o ao nome da classe analisadora especificado.

Uma parte da árvore de elementos de sintaxe que pertence a um analisador pode apenas ter sua raiz efetiva na primeira geração de elementos (ou seja, como filhos imediatos da raiz). A interface do nó definido pelo usuário não restringe a capacidade de criar uma subárvore que parece pertencer a um analisador diferente. Entretanto, não é possível serializar essas árvores de elementos em um fluxo de bits ao produzir uma mensagem.

Se você especificar o nome de um analisador fornecido com o WebSphere Message Broker, deverá utilizar o nome de classe correto do analisador. Consulte Funções de Implementação de Nó C para obter uma lista dos analisadores fornecidos.

O nome interno para o analisador BLOB é nenhum. Portanto, se você usar esta função para criar uma pasta analisadora BLOB, o nome do analisador associado deverá ser none.

Sintaxe

CciElement* cniCreateElementAsLastChildUsingParser(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  parserClassName);

Parâmetros

returnCode
O código de retorno da função (saída).
Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_PARSER_NAME
targetElement
O endereço do objeto do elemento (entrada).
parserClassName
O nome da classe do analisador (entrada).

Valores de Retorno

Se for bem-sucedido, o endereço do novo objeto de elemento é retornado. Caso contrário, um valor de zero (CCI_NULL_ADDR) é retornado, e o parâmetro returnCode indica a razão do erro.

Exemplo

    cniElementName(&rc, firstChild, elementName);
    CciElementType type = cniElementType(&rc, firstChild);
    CciElement* lastChild = cniCreateElementAsLastChildUsingParser(
                                                                  &rc, 
                                                                  outRootElement, 
                                                                  parserName);
    cniSetElementName(&rc, lastChild, elementName);
    cniSetElementType(&rc, lastChild, elementType);
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:23


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