cniGetAttribute

Esta função obtém o valor de um atributo em uma instância do nó específica.

Restrição: Esta função impõe uma restrição no comprimento do valor de atributo. Esta função é fornecida apenas para compatibilidade com versões anteriores. Você deve implementar cniGetAttribute2.
Esta função é chamada pelo intermediário:
  • Antes da implementação da configuração do nó para verificar os valores padrão para quaisquer atributos que podem substituir atributos pertencentes à estrutura.
  • Após a definição da configuração implementada para gravar a configuração no banco de dados do intermediário. Esta chamada assegura que a configuração persista no encerramento e reinícios do grupo de execução
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 cniGetAttribute e cniGetAttribute2 forem implementados, cniDefineNodeClass falhará com CCI_INV_IMPL_FUNCTION.
Definido em Type Membro
CNI_VFT Opcional iFpGetAttribute

Sintaxe

int cniGetAttribute(
  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).
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 bytes, do buffer especificado no parâmetro buffer (entrada).

Valores de Retorno

Se bem-sucedida, zero é retornado e a representação de caractere do valor do atributo é retornada no buffer especificado. Se o nome do atributo não identificar um suportado pelo nó, um valor diferente de zero é retornado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:04:51


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.1 | as07460_