cniSetAttribute

Esta função configura o valor de um atributo em uma instância do nó específica. Ela é chamada pelo broker quando um pedido de configuração que tenta configurar o valor de um atributo de nó é recebido ou durante a inicialização do nó.

Um nó recebe pedidos para definir atributos para a base. Se um valor de atributo desconhecido for recebido, esta função precisa retornar um valor diferente de zero para que o intermediário processe o pedido corretamente.

As responsabilidades do nó são:
  1. Verificar se o valor do atributo está especificado corretamente. Se não estiver, uma exceção de configuração deve ser lançada utilizando a função cciThrowException.
  2. Armazenar o valor do atributo dentro do contexto, o qual deve ter sido alocado na função cniCreateNodeContext.
  3. Lança uma exceção de configuração se um erro ocorrer, mas usando a função cciThrowException.
Definido em Tipo Membro
CNI_VFT Opcional iFpSetAttribute

Sintaxe

int cniSetAttribute(
  CciContext* context,
  CciChar*     attrName,
  CciChar*     attrValue);

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 cujo valor deve ser definido (entrada).
attrValue
O valor do atributo (entrada).

Valores de Retorno

Se bem-sucedida, zero é retornado. 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, 2013Copyright IBM Corporation 1999, 2013.

        
        Última atualização
        
        Última atualização : 2013-02-27 20:23:41


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.2 | as07490_