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 마지막 갱신 날짜: 5월 12, 2006
as07742_