Códigos de Retorno e Valores da Função de Utilitário

Por convenção, o parâmetro de saída do código de retorno de todas as funções de utilidade é definido para indicar uma conclusão bem-sucedida ou não. A tabela a seguir lista todos os códigos de retorno com seu significados. Esses códigos de retorno estão definidos no arquivo de cabeçalho BipCci.h.

Tabela 1. Códigos de Retorno e Valores da Função de Utilitário
Código de retorno Explicação
CCI_BUFFER_TOO_SMALL O buffer de saída não é grande o suficiente para armazenar os dados solicitados.
CCI_EXCEPTION Ocorreu uma exceção.
CCI_EXCEPTION_CONFIGURATION Uma exceção de configuração foi detectada ao chamar a função. 1
CCI_EXCEPTION_CONVERSION Uma exceção de conversão foi detectada ao chamar a função. 1
CCI_EXCEPTION_DATABASE Uma exceção de banco de dados foi detectada ao chamar a função.
CCI_EXCEPTION_FATAL Uma exceção fatal foi detectada ao chamar a função. 1
CCI_EXCEPTION_PARSER Uma exceção de analisador foi detectada ao chamar a função. 1
CCI_EXCEPTION_RECOVERABLE Uma exceção recuperável foi detectada ao chamar a função. 1
CCI_EXCEPTION_UNKNOWN Uma exceção desconhecida foi especificada ou encontrada.
CCI_EXCEPTION_USER Uma exceção de usuário foi detectada ao chamar a função. 1
CCI_FAILURE Uma função não foi bem-sucedida.
CCI_FAILURE_CONTINUE Valor de retorno cniRun(): reverter processamento de mensagem e continuar a execução do encadeamento
CCI_FAILURE_RETURN Valor de retorno cniRun(): reverter processamento de mensagem e retornar o encadeamento ao conjunto
CCI_INV_CODEPAGE Um número de página de códigos inválido foi especificado.
CCI_INV_CHARACTER Foi detectado um caractere inválido no buffer a ser convertido.
CCI_INV_DATA_BUFLEN Foi especificado um comprimento de buffer igual a zero.
CCI_INV_DATA_POINTER Foi especificado um ponteiro nulo para o endereço de uma área de dados de saída.
CCI_INV_ELEMENT_OBJECT Foi especificado um ponteiro nulo para o objeto elemento.
CCI_INV_FACTORY_NAME Foi especificado um nome de fábrica inválido (em branco).
CCI_INV_FACTORY_OBJECT Foi especificado um ponteiro nulo para o objeto fábrica.
CCI_INV_IMPL_FUNCTION Foi especificada uma combinação inválida de funções de implementação condicional.
CCI_INV_LENGTH Foi especificado um comprimento igual a zero.
CCI_INV_LOG_TYPE O tipo de registro especificado não é válido.
CCI_INV_MESSAGE_CONTEXT Foi especificado um ponteiro nulo para o contexto da mensagem.
CCI_INV_MESSAGE_OBJECT Foi especificado um ponteiro nulo para o objeto mensagem.
CCI_INV_NODE_ENV Tentativa de dispatch de um encadeamento a partir de um nó que não é de entrada.
CCI_INV_NODE_NAME Foi especificado um nome de nó inválido (em branco).
CCI_INV_NODE_OBJECT Foi especificado um ponteiro nulo para o objeto nó.
CCI_INV_OBJECT_NAME Caracteres inválidos especificados no nome do objeto.
CCI_INV_PARSER_NAME Foi especificado um nome de classe do analisador inválido (em branco).
CCI_INV_PARSER_OBJECT Foi especificado um ponteiro nulo para o objeto analisador.
CCI_INV_SQL_EXPR_OBJECT Foi especificado um ponteiro nulo para o valor de uma expressão SQL.
CCI_INV_STATEMENT Uma instrução não foi especificada.
CCI_INV_TERMINAL_NAME Foi especificado um nome de terminal inválido (em branco).
CCI_INV_TERMINAL_OBJECT Foi especificado um ponteiro nulo para o objeto terminal.
CCI_INV_TRANSACTION_TYPE Foi especificado um valor inválido para o tipo de transação.
CCI_INV_VFTP Um ponteiro nulo foi especificado para o endereço da tabela do ponteiro da função virtual da extensão definida pelo usuário.
CCI_MISSING_IMPL_FUNCTION Uma função de implementação obrigatória não foi definida na tabela de ponteiros de função.
CCI_NAME_EXISTS Já existe um analisador com o mesmo nome de classe.
CCI_NO_BUFFER_EXISTS Não existe nenhum buffer para o objeto do analisador especificado.
CCI_NO_EXCEPTION_EXISTS Nenhuma exceção anterior foi localizada para este encadeamento.
CCI_NO_THREADS_AVAILABLE Nenhum encadeamento está disponível para dispatch.
CCI_NULL_ADDR Uma função que deve retornar um endereço não foi bem-sucedida; zero é retornado.
CCI_PARSER_NAME_TOO_LONG O nome da classe do analisador é muito longo.
CCI_SUCCESS Conclusão bem-sucedida.
CCI_SUCCESS_CONTINUE Valor de retorno cniRun(): consolidar processamento de mensagem e continuar a execução do encadeamento
CCI_SUCCESS_RETURN Valor de retorno cniRun(): consolidar processamento de mensagem e retornar o encadeamento ao conjunto
CCI_TIMEOUT Valor de retorno cniRun(): nenhum processamento de mensagem, mas continuar a execução do encadeamento
Nota:
  1. Esse código de retorno é retornado somente por cniGetLastExceptionData para indicar o tipo da última exceção.
Referências relacionadas
Funções de Utilitários Comuns C
Arquivos de Cabeçalho
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as08557_