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.

Notices | Trademarks | Downloads | Library | Support | Feedback
Copyright IBM Corporation 1999, 2006 Last updated: 5월 25, 2006
as07490_