cniGetAttributeName2

이 함수는 색인이 지정하는 노드 속성의 이름을 리턴합니다. 브로커가 특정 노드 인스턴스가 지원하는 속성 이름을 필요로 할 경우 메시지 브로커가 이 함수를 호출합니다. 이 함수는 속성을 알려진 정의된 순서로 리턴하고 색인 매개변수가 나타내는 속성 이름을 리턴하도록 보장해야 합니다.

cniGetAttributeNamecniGetAttributeName2가 둘 다 구현되면 cniDefineNodeClass는 CCI_INV_IMPL_FUNCTION으로 실패합니다.

정의 대상 유형 구성원
CNI_VFT 선택 iFpGetAttributeName2

구문

CciSize cniGetAttributeName2(
  int          returnCode,
    CciContext* context,
    int          index,
    CciChar*    buffer,
    int          bufsize);

매개변수

context
노드가 작성하고 cniCreateNodeContext 함수가 리턴한 노드 인스턴스의 컨텍스트 주소(입력)
returnCode(출력)
int에 대한 포인터. 리턴 시 노드는 이 int가 완료 상태를 설명하는 값을 저장하는지 확인해야 합니다. 가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_ATTRIBUTE_UNKNOWN
  • CCI_BUFFER_TOO_SMALL
index
속성 이름의 색인을 지정합니다(입력). 속성 색인은 0에서 시작합니다.
buffer
속성 이름을 복사할 버퍼의 주소(출력).
bufsize
buffer 매개변수에 지정된 버퍼 길이(CciChars 단위)(입력)

리턴 값

  • 함수가 정상적으로 실행되면, 속성 이름이 제공된 버퍼로 복사되며 복사된 CciChar 문자 수가 리턴됩니다.
  • 버퍼가 속성 이름을 포함할 만큼 크지 않은 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 CciChars 수가 리턴됩니다.
  • 속성 목록의 끝에 도달하고 속성 이름을 찾을 수 없는 경우, returnCode는 CCI_ATTRIBUTE_UNKNOWN으로 설정됩니다. index가 n-1보다 큰 경우를 예로 들 수 있습니다(여기서 n은 이 노드의 속성 수).
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as24699_