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

cciGetNodeName

Essa função retorna o nome do nó especificado.

O nome é designado internamente pelo WebSphere Message Broker Toolkit e é exclusivo no fluxo de mensagens. O rótulo que é designado para um nó pelo designer do fluxo de mensagens no Editor do Fluxo de Mensagens pode ser obtido chamando cciGetNodeAttribute para ler o atributo do rótulo.

Sintaxe

CciSize getNodeName (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 conter o valor do nome do 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 nome do nó.
length
O comprimento, em CciChars, do buffer alocado pelo responsável pela chamada.

Valores de Retorno

  • Se bem-sucedido, o nome do nó é 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 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* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /* agora verifique o rc a procura de valores inesperados*/
   /*se rc for CCI_BUFFER_TOO_SMALL, redimensione e tente novamente*/

}  
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:30


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