cniGetAttribute2

이 함수는 특정 노드 인스턴스의 속성 값을 가져옵니다. 사용자가 전개하는 모든 속성이 설정된 후에 메시지 브로커가 이 함수를 호출합니다. 실행 그룹 프로세스가 정지 및 시작된 후에 노드가 올바르게 구성되었는지 확인하기 위해 결과가 브로커의 지속 구성 저장소에 기록됩니다.

이때 노드의 역할은 다음과 같습니다.
  1. 속성 값의 문자 표현을 리턴합니다.
  2. 오류가 발생할 경우 예외를 전달합니다.

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

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

구문

CciSize cniGetAttribute2(
  int          returnCode,
    CciContext* context,
    CciChar*     attrName,
    CciChar*    buffer,
    int          bufsize);

매개변수

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

리턴 값

  • 함수가 정상적으로 실행되면, 속성 값이 제공된 버퍼로 복사되며 복사된 CciChar 문자 수가 리턴됩니다.
  • 버퍼가 속성 값을 포함할 만큼 크지 않은 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 CciChars 수가 리턴됩니다.
  • attrName이 노드에 알려지지 않은 경우, returnCode는 CCI_ATTRIBUTE_UNKNOWN으로 설정됩니다.
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as24698_