cniFinalize

브로커가 지정된 메시지의 종료 처리를 수행하는 종료 기능을 지원하는 구문 분석기를 요청하도록 합니다. 이 처리의 작동한 각 구문 분석기에 따라 다릅니다.

options 매개변수가 CCI_FINALIZE_VALIDATE로 설정된 경우, 구문 분석기는 유효성 검증 처리 또한 수행하여 해당 구문 분석기가 소유하는 요소 트리가 올바른 구조로 되어 있는지 확인해야 합니다. 그러면 잘못 구성된 요소 트리가 메시지 플로우의 다른 노드로 전달되지 않게 됩니다.

cniFinalize는 메시지를 전달하기 전에(예를 들면, cniWriteBuffer를 호출하기 전에) 호출하는 것이 좋습니다.

구문

void cniFinalize(
    int*                   returnCode,
    CciMessage*        message,
    int          options);

매개변수

returnCode
함수의 리턴 코드(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
요소 트리를 완료할 메시지 오브젝트의 주소(입력).
options
종료 또는 유효성 검증 옵션 사용을 나타내는 비트 플래그를 지정합니다(입력). 이 매개변수는 선택적입니다. 이를 CCI_FINALIZE_VALIDATE로 설정할 수 있습니다.

리턴 값

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

            cniFinalize(&rc, outMsg, CCI_FINALIZE_NONE);
            retvalue = cniPropagate(
                                                                                               &rc, 
                                                          terminalObject, 
                                                          destinationList, 
                                                          exceptionList, 
                                                          outMsg);

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