cciInputMessageCallback

이 함수는 콜백으로 등록될 수 있는 함수이며, 입력 노드가 메시지를 읽을 때마다 읽혀진 메시지가 메시지 플로우를 통해 전달되기 전에 호출됩니다. 이 함수는 사용자 엑시트 상태가 활성인 경우, 콜백이 등록된 실행 그룹 내에서 입력 메시지를 읽을 때마다 호출됩니다. CCI_UE_VFT 구조의 iFpInputMessageCallback 필드가 cciRegisterUserExit에 전달될 때 이 함수에 포인터를 제공함으로써 콜백이 등록됩니다.

구문

typedef void (*cciInputMessageCallback)     ( 
                                 CciDataContext*  userContext,
                                   CciMessage*        message,
                                 CciMessage*      localEnvironment,
                                   CciMessage* exceptionList,
                                 CciMessage*      environment,
                                 CciMessageOrigin messageOrigin,
                                 CciNode*         inputNode);

매개변수

userContext(입력)
이 값은 cciRegisterUserExit 함수에 전달된 값입니다.
message
이 매개변수는 메시지 오브젝트의 핸들입니다. 사용자 엑시트 코드는 이 트리를 갱신하지 않아야 합니다.
localEnvironment
이 매개변수는 로컬 환경 오브젝트의 핸들입니다.
exceptionList
이 매개변수는 예외 목록 오브젝트의 핸들입니다.
environment
이 매개변수는 현재 메시지 플로우에 대한 환경 오브젝트의 핸들입니다.
messageOrigin
입력 노드의 유형에 따라 메시지는 비트스트림(CCI_MESSAGE_ORIGIN_BITSTREAM)에서 생성되었을 수도 있고, 트리(CCI_MESSAGE_ORIGIN_TREE)에서 생성되었을 수도 있습니다. 따라서 사용자 엑시트는 구문 분석기에 의한 처리를 발생시키지 않으며 둘 중 하나에 엑세스할 수 있습니다. 예를 들어 MQInputNode의 경우에는 비트스트림에 안전하게 액세스할 수 있으며, JMS 입력 노드의 경우에는 트리에 안전하게 액세스할 수 있습니다. cniBufferPointer, cniBufferSize 또는 cniBufferByte를 호출함으로써 비트스트림에 액세스할 수 있습니다. cniRootElement를 호출하고 일반적인 구문 요소 탐색 함수(예: cniFirstChild)를 사용함으로써 트리에 액세스할 수 있습니다.
주: 이 매개변수는 구문 분석기에 의한 처리를 발생시키지 않으며 사용자 엑시트가 안전하게 액세스할 수 있는 것이 무엇인지 알려주지만 사용자 엑시트 코드는 이 정보를 무시하고 구문 분석 타이밍을 실질적으로 변경할 수 있습니다.
inputNode
이 매개변수는 해당 입력 메시지를 읽는 입력 노드의 핸들입니다. 이 매개변수는 cciGetNodeName, cciGetNodeTypecniGetBrokerInfo 등의 함수를 호출하는 데 사용될 수 있습니다.

리턴 값

없음

void myInputMessageCallback(
                      CciDataContext*  userContext,
                        CciMessage*        message,
                      CciMessage*      localEnvironment,
                        CciMessage* exceptionList,
                      CciMessage*      environment,
                      CciMessageOrigin messageOrigin,
                      CciNode*         inputNode){
…
…
}
관련 태스크
사용자 엑시트 개발
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as35950_