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

cniGetAttribute2

Use esta função para obter o valor de um atributo em uma instância do nó específica. Ela é chamada pelo broker após todos os atributos que o usuário implementa serem configurados.

Os resultados são gravados nos dados de configuração persistentes do broker para assegurar que o nó seja configurado corretamente após o processo do grupo de execução ser parado e iniciado.

As responsabilidades do nó são:
  1. Retornar uma representação de caractere do valor do atributo.
  2. Lançar uma exceção se um erro ocorrer.

Se as funções cniGetAttribute e cniGetAttribute2 forem implementadas, cniDefineNodeClass falhará com o código de retorno CCI_INV_IMPL_FUNCTION.

Definido em Tipo Membro
CNI_VFT Opcional iFpGetAttribute2

Sintaxe

CciSize cniGetAttribute2(
  int          returnCode,
  CciContext*  context,
  CciChar*     attrName,
  CciChar*     buffer,
  int          bufsize);

Parâmetros

context
O endereço do contexto para a instância do nó, conforme criado pelo nó e retornado pela função cniCreateNodeContext (entrada).
returnCode (saída)
Ponteiro para um int. No retorno, o nó deve assegurar que este int armazene um valor que descreva o status da conclusão. Os possíveis códigos de retorno são:
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
attrName
O nome do atributo para o qual o valor deve ser recuperado (entrada).
buffer
O endereço de um buffer no qual o valor do atributo é copiado (saída).
bufsize
O comprimento, em CciChars, do buffer especificado no parâmetro buffer (entrada).

Valores de Retorno

  • Se bem-sucedido, o valor de atributo é copiado no buffer fornecido e o número de caracteres CciChar copiados é retornado.
  • Se o buffer não for grande o suficiente para conter o valor de atributo, returnCode será configurado como CCI_BUFFER_TOO_SMALL e o número de CciChars necessários será retornado.
  • Se o attrName não for conhecido neste nó, returnCode será configurado como CCI_ATTRIBUTE_UNKNOWN.
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:28


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