cpiElementName

목적

대상 구문 요소의 이름을 가져옵니다. 구문 요소 이름은 이전에 cniSetElementName 또는 cpiSetElementName을 사용하여 설정되었습니다.

구문

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

매개변수

returnCode
함수의 리턴 코드를 수신합니다(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_ELEMENT_OBJECT
  • CCI_INV_DATA_POINTER
  • CCI_INV_DATA_BUFLEN
  • CCI_INV_BUFFER_TOO_SMALL
targetElement
대상 구문 요소 오브젝트의 주소를 지정합니다(입력).
value
요소 이름이 복사될 버퍼의 주소를 지정합니다(입력).
length
value 매개변수에 지정된 문자의 길이(입력).

리턴 값

함수가 정상적으로 실행되면, 요소 이름이 제공된 버퍼로 복사되며 복사된 CciChar 문자 수가 리턴됩니다. 버퍼가 요소 이름을 포함할 만큼 충분히 크지 않을 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 문자 수가 리턴됩니다. 다른 오류가 발생할 경우, CCI_FAILURE가 리턴되고 returnCode는 오류의 이유를 표시합니다.

샘플

cpiElementName(&rc;, element, (CciChar*)&elementName;, sizeof(elementName));
관련 개념
사용자 정의 구문 분석기
사용자 정의 확장 구성요소
관련 태스크
C로 구문 분석기 작성
관련 참조
cpiElementType
cpiElementValue 그룹
cpiElementValueValue
C 구문 분석기 유틸리티 함수
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08430_