cniSetAttribute

Define o valor de um atributo em uma instância específica do nó. É chamada pelo intermediário de mensagens quando um pedido de configuração é recebido e que tenta definir o valor de um atributo do nó, 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ó neste ponto são de:
  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çar uma exceção de configuração se um erro ocorrer, utilizando a função cciThrowException.
Definido em Type 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
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as07490_