cciThrowException

예외를 전달합니다. 예외 데이터로 지정된 인수를 사용하여 메시지 브로커 인터페이스가 예외를 전달합니다.

구문

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

매개변수

returnCode
함수의 리턴 코드(출력). 가능한 리턴 코드는 CCI_INV_DATA_POINTER입니다.
유형(type)
예외의 유형(입력). 올바른 값은 다음과 같습니다.
  • CCI_FATAL_EXCEPTION
  • CCI_RECOVERABLE_EXCEPTION
  • CCI_CONFIGURATION_EXCEPTION
  • CCI_PARSER_EXCEPTION
  • CCI_CONVERSION_EXCEPTION
  • CCI_DATABASE_EXCEPTION
  • CCI_USER_EXCEPTION
file
예외가 생성된 소스 파일 이름(입력). 값은 선택적이지만 디버깅용으로 유용합니다.
line
예외가 생성된 소스 파일의 행 번호(입력). 값은 선택적이지만 디버깅용으로 유용합니다.
function
예외가 생성된 함수 이름(입력). 값은 선택적이지만 디버깅용으로 유용합니다.
messageSource
Windows 메시지 소스 또는 Linux 및 UNIX 메시지 카탈로그를 나타내는 문자열
messageNumber
예외를 나타내는 메시지 번호(입력). messageNumber가 0으로 지정된 경우, 메시지가 사용 불가능한 것으로 간주됩니다. messageNumber가 0이 아닌 경우, 변수 인수 목록에 제공된 모든 삽입항목과 함께 브로커 이벤트 로그에 지정된 메시지가 기록됩니다.
traceText
브로커 서비스 추적 로그에 기록된 추적 정보(입력). 정보는 선택사항이지만 디버깅용으로 유용합니다.
...
메시지와 함께 오는 모든 메시지 삽입 항목이 들어 있는 C 변수 인수 목록(입력). 이러한 삽입항목은 문자열로 간주되고, 변수 인수는 pointer to char 유형으로 간주됩니다.
주: char* 문자는 ASCII(라틴) 또는 EBCDIC(1047)의 문자열이어야 합니다.
주: 이 목록의 마지막 인수는 반드시 (char*)0이어야 합니다.

리턴 값

없음. 오류가 발생할 경우, returnCode 매개변수는 오류의 이유를 표시합니다.

주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08554_