cniGetAttributeName

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 cniGetAttributeName2.

Retorna o nome de um atributo do nó especificado por um índice. É chamada pelo intermediário de mensagens quando este precisar dos nomes de atributos suportados por uma determinada instância de um nó. A função deve garantir o retorno dos atributos em uma ordem conhecida e definida, e o retorno do nome do atributo representado pelo parâmetro index.

Se cniGetAttributeName e cniGetAttributeName2 forem implementados, cniDefineNodeClass falhará com CCI_INV_IMPL_FUNCTION.

Definido em Type Membro
CNI_VFT Opcional iFpGetAttributeName

Sintaxe

int cniGetAttributeName(
    CciContext*  context,
    int          index,
    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).
index
Especifica o índice do nome do atributo (entrada). O índice dos atributos começa de zero.
buffer
O endereço de um buffer no qual o nome 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 o nome do atributo é retornado no buffer especificado. Se o final da lista de atributos for alcançado, 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
as07470_