cniElementName

Obtém o valor do atributo name para o elemento de sintaxe especificado. O nome do elemento de sintaxe terá sido definido anteriormente utilizando cniSetElementName ou cpiSetElementName.

Sintaxe

CciSize cniElementName(
  int*            returnCode,
  CciElement*     targetElement,
  const CciChar*  value,
  Ccisize         length);

Parâmetros

returnCode
O código de retorno da função (saída).
targetElement
O endereço do objeto do elemento de sintaxe de destino (entrada).
value
O endereço de um buffer no qual o nome do elemento é copiado (entrada).
length
O comprimento, em caracteres, especificado pelo parâmetro value (entrada).

Valores de Retorno

  • Se bem-sucedida, o nome do elemento é copiado para o buffer fornecido e o número de caracteres CciChar copiado é retornado.
  • Se o buffer não for grande o suficiente para conter o nome do elemento, returnCode é definido como CCI_BUFFER_TOO_SMALL e o número de bytes necessário é retornado.
  • Para qualquer outra falha, CCI_FAILURE é retornado e returnCode indica a razão do erro.

Conceitos relacionados
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções Utilitárias de Nó em Linguagem C
cniElementAsBitstream
cniElementNamespace
cniElementType
Grupo cniElementValue
cniElementValueState
cniElementValueType
cniElementValueValue
cniSetElementName
cpiSetElementName