cpiCreateContext

목적

구문 분석기 오브젝트와 연관된 사용자 정의 확장 컨텍스트를 작성합니다. 구문 분석기 오브젝트의 인스턴스가 구성 또는 할당될 때 메시지 브로커에 의해 호출됩니다. 메시지 플로우에 의해 메시지 데이터가 구문 분석될 때 이러한 상황이 발생합니다. 이 함수가 호출되기 전에 브로커는 이름 요소를 구문 분석기의 유효한 루트 요소로 작성한 상태입니다. 그러나, 이 요소의 이름은 지정되지 않았습니다. 구문 분석기는 cpiSetElementName 함수에 이 요소의 이름을 지정합니다.

확장자의 역할은 다음과 같습니다.
  1. 필요할 수 있는 모든 구문 분석기 인스턴스별 데이터 영역(컨텍스트 등)을 할당합니다.
  2. 필요할 수 있는 모든 추가 자원 취득 또는 초기화를 수행합니다.
  3. 컨텍스트의 주소를 호출 함수로 돌려보냅니다. 이 구문 분석기 인스턴스의 구현 함수가 호출될 때마다 해당 함수의 인수로서 적절한 컨텍스트가 전달됩니다. 즉, C로 개발된 사용자 정의 구문 분석기는 인스턴스별 데이터 영역에 자체 static 포인터를 유지할 필요가 없습니다.
정의 대상 유형 구성원
CPI_VFT 필수 iFpCreateContext

구문

void cpiCreateContext(
    CciParser*  parser);

매개변수

parser
구문 분석기 오브젝트의 주소(입력)

리턴 값

함수가 정상적으로 실행되면, 사용자 정의 확장 컨텍스트의 주소가 리턴됩니다. 그렇지 않으면 제로(0) 값이 리턴됩니다.

관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 참조
C 구문 분석기 구현 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08095_