Restrição: Esta função impõe uma restrição no comprimento
do valor de atributo. Esta função é fornecida apenas para retrocompatibilidade.
Você deve implementar cniGetAttribute2.
Esta função obtém o valor de um atributo em uma instância do nó específica. Ela é chamada pelo intermediário de mensagem da seguinte maneira:
Antes de a configuração dos nós ser implementada para averiguar os valores padrão de quaisquer atributos que podem sobrepor atributos pertencentes à estrutura.
Após definir a configuração implementada para gravar a configuração
no banco de dados do Intermediário. Isso garante que a configuração permaneça nos encerramentos
e nos reinícios do grupo de execução
As responsabilidades do nó neste ponto são de:
Retornar uma representação de caractere do valor do atributo.
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.