cniGetAttribute

제한사항: 이 함수는 속성 값 길이에 대한 제한을 부여합니다. 이 함수는 역호환성을 위해서만 제공됩니다. cniGetAttribute2를 구현해야 합니다.

이 함수는 특정 노드 인스턴스의 속성 값을 가져옵니다. 노드 속성 값을 검색하는 보고서 요청이 수신될 때 메시지 브로커에 의해 호출됩니다. 브로커는 속성 이름이 노드에 맞는 올바른 것인지 확인합니다.

이때 노드의 역할은 다음과 같습니다.
  1. 속성 값의 문자 표현을 리턴합니다.
  2. 오류가 발생할 경우 예외를 전달합니다.
cniGetAttributecniGetAttribute2가 둘 다 구현되면 cniDefineNodeClass는 CCI_INV_IMPL_FUNCTION으로 실패합니다.
정의 대상 유형 구성원
CNI_VFT 선택 사항 iFpGetAttribute

구문

int cniGetAttribute(
  CciContext* context,
  CciChar*     attrName,
  CciChar*    buffer,
  int          bufsize);

매개변수

context
노드가 작성하고 cniCreateNodeContext 함수가 리턴한 노드 인스턴스의 컨텍스트 주소(입력).
attrName
값이 검색될 속성 이름(입력).
buffer
속성 값을 복사할 버퍼의 주소(출력).
bufsize
buffer 매개변수에 지정된 버퍼 길이(바이트 단위)(입력).

리턴 값

성공하면 0이 리턴되며 속성 값의 문자 표현이 지정된 버퍼에 리턴됩니다. 속성 이름이 노드가 지원하는 이름을 나타내지 않을 경우, 0이 아닌 값이 리턴됩니다.

주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 5월 12, 2006
as07460_