cniGetAttribute

Obtém o valor de um atributo em uma instância específica do nó. É chamada pelo intermediário de mensagens quando um pedido de relatório é recebido, o qual recupera o valor de um atributo do nó. O intermediário verifica se o nome do atributo é válido para o nó.

As responsabilidades do nó neste ponto são de:
  1. Retornar uma representação de caractere do valor do atributo.
  2. Retornar uma cadeia nula se os dados forem sensíveis e não puderem ser exibidos em relatórios.
  3. Lançar uma exceção se um erro ocorrer.
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.

Conceitos relacionados
Nós Input definidos pelo usuário
Nós de Processamento de Mensagem Definidos pelo Usuário
Nós de Saída Definidos pelo Usuário

Tarefas relacionadas
Criando um Nó de Entrada em C
Criando um Nó de Processamento de Mensagem em C

Referências relacionadas
Funções de Implementação de Nó em Linguagem C
cniCreateNodeContext
cniGetAttributeName