cniRootElement

지정된 메시지와 연관된 루트 구문 요소를 가져옵니다. message 매개변수에 지정된 메시지 오브젝트와 연관된(그리고 메시지 오브젝트가 소유하는) 루트 요소를 리턴합니다. 브로커가 메시지 오브젝트를 구성할 때, 루트 요소가 자동으로 작성됩니다.

구문

CciElement* cniRootElement(
    int*                   returnCode,
    CciMessage*        message);

매개변수

returnCode
함수의 리턴 코드(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
메시지 오브젝트의 주소(입력).

리턴 값

함수가 정상적으로 실행되면, 루트 요소 오브젝트의 주소가 리턴됩니다. 정상적으로 실행되지 않으면, 0 값(CCI_NULL_ADDR)이 리턴되고 returnCode 매개변수는 오류의 이유를 표시합니다.

      inRootElement = cniRootElement(&rc, message);
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as07680_