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 마지막 갱신 날짜: 2006/08/21
as08185_