cpiElementNameSpace

목적

지정된 구문 요소의 "namespace" 속성 값을 가져옵니다.

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

구문

CciSize cpiElementNamespace(
   int*                   returnCode,
   CciElement*            targetElement,
     const CciChar*             value,
     CciSize        length);

매개변수

returnCode
널(null) 포인터 입력은 사용자 정의 노드가 오류를 처리하지 않음을 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 실행 중 예외가 발생할 경우, *returnCode는 출력에 CCI_EXCEPTION으로 설정됩니다. CciGetLastExceptionData 호출은 예외에 대한 자세한 내용을 제공합니다. 호출자가 네임스페이스 값을 보유할 충분한 메모리를 할당하지 않으면, *returncode는 CCI_BUFFER_TOO_SMALL로 설정됩니다.
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
대상 구문 요소 오브젝트의 주소를 지정합니다.
value
요소 네임스페이스 값을 복사할 버퍼의 주소를 지정합니다. 네임스페이스 값을 나타내는 문자열(널(null) 종료 문자 포함)이 이 버퍼에 복사됩니다. 버퍼는 이전에 호출자가 할당한 메모리의 일부여야 합니다.
length
value 매개변수에 지정된 버퍼 길이(CciChars 단위)

리턴 값

함수가 정상적으로 실행되면, 버퍼에 복사된 CciChars의 수가 리턴됩니다.

버퍼가 속성 값을 포함할 만큼 충분히 크지 않을 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 CciChars 바이트 수가 리턴됩니다.

샘플

      elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
          elementNamespaceLength = cpiElementNamespace(&rc;,
                                                                           element,
                                                                           elementNamespace,
                                                                           elementNamespaceLength);
    
        if (rc==CCI_BUFFER_TOO_SMALL){
            free(elementNamespace);
            elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
            elementNamespaceLength = cpiElementNamespace(&rc;,
                                                                           element,
                                                                           elementNamespace,
                                                                           elementNamespaceLength);
    }
       checkRC(rc);
관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 태스크
C로 구문 분석기 작성
관련 참조
cpiSetElementNamespace
C 구문 분석기 구현 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08105_