cciThrowException

Utilize cciThrowException para lançar uma exceção.

A exceção é lançada pela interface do intermediário e inclui os argumentos especificados como dados da exceção.

Sintaxe

void cciThrowException(
  int*                returnCode,
  CCI_EXCEPTION_TYPE  type,
  char*               file,
  int                 line,
  char*               function,
  CciChar*            messageSource,
  int                 messageNumber,
  char*               traceText,
                      ...);

Parâmetros

returnCode
O código de retorno da função (saída). O código de retorno possível é CCI_INV_DATA_POINTER.
type
O tipo de exceção (entrada). Os valores válidos são:
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
file
O nome do arquivo de origem onde a exceção foi gerada (entrada). O valor é opcional, mas é útil para fins de depuração.
line
O número da linha no arquivo de origem onde a exceção foi gerada (entrada). O valor é opcional, mas é útil para fins de depuração.
function
O nome da função que gerou a exceção (entrada). O valor é opcional, mas é útil para fins de depuração.
messageSource
O local e nome completos da origem da mensagem do Windows ou o catálogo de mensagens do Linux, UNIX ou z/OS.

Início da mudançaPara utilizar o catálogo de mensagens do intermediário atual, especifique BIPv600 em todos os sistemas operacionais. Alternativamente, você pode criar seu próprio catálogo de mensagens.Fim da mudança

messageNumber
O número da mensagem identificando a exceção (entrada). Se messageNumber for especificado como zero, supõe-se que a mensagem não está disponível. Se messageNumber for diferente de zero, a mensagem especificada é gravada no registro de eventos do intermediário com quaisquer inserções fornecidas na lista de argumentos variáveis.
traceText
Informações de rastreio que são gravadas no registro de rastreio de serviço do intermediário (entrada). As informações são opcionais, mas são úteis na depuração de problemas.
...
Uma lista de argumentos variáveis em C contendo quaisquer inserções de mensagem que acompanham a mensagem (entrada). Essas inserções são tratadas como cadeias de caracteres, e os argumentos variáveis são considerados como sendo do tipo pointer to char.

Os caracteres char* devem ser cadeias em ASCII (Latino) ou EBCDIC (1047).

O último argumento nesta lista deve ser (char*)0.

Valores de Retorno

Nenhuma. Se ocorrer um erro, o parâmetro returnCode indica o motivo do erro.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:13:10

as08554_