cpiSetElementNamespace

목적

지정된 구문 요소의 "namespace" 속성을 설정합니다.

정의 대상 유형 구성원
CPI_VFT 선택 사항 iFpSetElementValue

구문

void             cpiSetElementNamespace(
  int*                   returnCode,
  CciElement*            targetElement,
const CciChar* nameSpace);

매개변수

returnCode
널(null) 포인터 입력은 사용자 정의 노드가 오류를 처리하지 않음을 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 실행 중 예외가 발생할 경우, *returnCode는 출력에 CCI_EXCEPTION으로 설정됩니다. CciGetLastExceptionData 호출은 예외에 대한 자세한 내용을 제공합니다 (입력). 가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
currentElement
현재 구문 요소의 주소(입력)
targetElement
대상 구문 요소 오브젝트의 주소를 지정합니다.
value
네임스페이스 값을 나타내는 CciChars의 널(Null) 종료 문자열 주소를 지정합니다. 빈 문자열은 네임스페이스의 올바른 값입니다. 실제, 기본적으로 요소는 빈 문자열 네임스페이스에 작성되므로, API를 통해 빈 문자열을 네임스페이스로 지정하면 요소가 이전에 다른 네임스페이스에 있었으며 네임스페이스 값을 빈 문자열로 바꾸려고 하는 경우에만 효과가 있습니다.

리턴 값

없음

샘플

          /* Convert the attribute value into broker form */
data = CciNString((char *)startMarker, markedSize, pc->iCcsid);
          /* Create a new name-value element for the attribute */
        newElement = cpiCreateElement(&rc, parser);
          cpiSetElementType(&rc, newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
        cpiSetElementName(&rc, newElement, data);
          cpiSetElementNamespace(&rc, newElement, data);
if (pc->trace) {
const char * mbData = mbString(data, pc->iCcsid);
fprintf(pc->tracefile, "PLUGIN: Created new NAMESPACEVALUE element;
                  object=0x%x type=0x%x name=",
                    newElement, CCI_ELEMENT_TYPE_NAME_VALUE);
fprintf(pc->tracefile, "%s\n", mbData);
fflush(pc->tracefile);
          free((void *)mbData);
}
          /* Free the memory created in CciNString() */
        free((void *)data);
        /* Add the element */
        cpiAddAsLastChild(&rc, element, newElement);
관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 태스크
C로 구문 분석기 작성
관련 참조
cpiElementNameSpace
C 구문 분석기 구현 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 5월 12, 2006
as08185_