cniElementNamespace

지정된 구문 요소의 namespace 속성 값을 가져옵니다. 구문 요소 이름은 이전에 cniSetElementNamespace 또는 cpiSetElementNamespace을 사용하여 성정됩니다.

네임스페이스를 인식하는 도메인에 속하는 메시지를 비트스트림으로 변환할 때 사용됩니다.

구문

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

매개변수

returnCode
함수의 리턴 코드(출력). 널(null) 포인터는 노드가 오류를 처리하지 않음을 의미합니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 예외에 대한 자세한 내용은 cciGetLastExceptionData를 호출하십시오.
가능한 리턴 코드는 다음과 같습니다.
  • 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의 수가 리턴됩니다.
  • 버퍼가 속성 값을 포함할 만큼 충분히 크지 않을 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 CciChars 수가 리턴됩니다.
  • 실행 중 예외가 발생할 경우, returnCode는 CCI_EXCEPTION으로 설정됩니다.

   if (element != 0) {
        /*get name*/
        cniElementName(&rc, element, (CciChar*)&elementName, sizeof(elementName));

        /*get namespace*/
          elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
          elementNamespaceLength = cniElementNamespace(&rc,
                                                                                                    element,
                                                                                                    elementNamespace,
                                                                                                    elementNamespaceLength);
    
        if (rc==CCI_BUFFER_TOO_SMALL){
            free(elementNamespace);
            elementNamespace=(CciChar*)malloc(sizeof(CciChar) * elementNamespaceLength);
            elementNamespaceLength = cniElementNamespace(&rc,
                                                                                                      element,
                                                                                                      elementNamespace,
                                                                                                      elementNamespaceLength);
    }
    checkRC(rc);
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as07742_