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, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização
        
        Última atualização : 2013-02-27 20:23:44


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