cciGetNodeType

Esta função retorna o tipo do nó especificado.

Sintaxe

CciSize cciGetNodeType (int* returnCode,
                                        CciNode* node,
                                        CciChar* value,
                                        CciSize length);

Parâmetros

returnCode (saída)
Recebe o código de retorno da função (saída).
  • CCI_INV_BUFFER_TOO_SMALL

    O buffer fornecido não era grande o suficiente para manter o valor do tipo de nó.

node (entrada)
Esta é uma manipulação para um nó.
value (saída)
Endereço de um buffer, alocado pelo responsável pela chamada para conter o valor do tipo de nó.
length
O comprimento, em CciChars, do buffer alocado pelo responsável pela chamada.

Valores de Retorno

  • Se a função for bem-sucedida, o tipo de nó será copiado no buffer fornecido e o número de caractere CciChar copiados será retornado.
  • Se o buffer não for grande o suficiente para conter o tipo do nó, returnCode será definido como CCI_BUFFER_TOO_SMALL, e o número de CciChars exigido será retornado.

Exemplo

void myPropagatedMessageCallback(
                        CciMessage* message,
                        CciMessage* localEnvironment,
                        CciMessage* exceptionList,
                        CciMessage* environment,
                        CciConnection* connection){
   
int rc = CCI_SUCCESS;
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /* agora verifique o rc a procura de valores inesperados*/

   CciChar sourceNodeType[initialStringBufferLength];
   sourceNodeTypeLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         sourceNodeType,
                                         initialStringBufferLength);
   /* agora verifique o rc a procura de valores inesperados*/
   /* se rc é CCI_BUFFER_TOO_SMALL, você deve redimensionar e tentar novamente*/
Conceitos relacionados
Saídas de usuário
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:13

as36000_