cciGetNodeAttribute

이 함수는 지정된 속성의 값을 리턴합니다.

구문

CciSize  cciGetNodeAttribute (int*           returnCode,
                         CciNode*       node,
                           CciChar*    name,
                         CciChar*       value,
                         CciSize         length);

매개변수

returnCode(출력)
함수의 리턴 코드를 수신합니다(출력).
  • CCI_INV_BUFFER_TOO_SMALL

    제공된 버퍼가 노드의 유형을 저장할 만큼 크지 않습니다.

node(입력)
이 매개변수는 노드의 핸들입니다.
name(입력)
이 매개변수는 조회되는 노드 속성의 이름을 지정하는 널(Null) 종료된 CciChar 문자열에 대한 포인터입니다.
value(출력)
속성의 값을 저장하도록 호출자가 할당하는 버퍼의 주소
length
호출자가 할당하는 버퍼의 길이(CciChars 단위)

리턴 값

  • 함수가 정상적으로 실행되면, 속성 값이 제공된 버퍼로 복사되며 복사된 CciChar 문자 수가 리턴됩니다.
  • 버퍼가 속성 값을 포함할 만큼 크지 않은 경우, returnCode는 CCI_BUFFER_TOO_SMALL로 설정되고 필요한 CciChars 수가 리턴됩니다.
  • name이 주어진 노드에 대해 적절하지 않는 속성 이름을 지정하면 returnCode는 CCI_ATTRIBUTE_UNKOWN로 설정됩니다.

void myPropagatedMessageCallback(
                          CciMessage*        message,
                        CciMessage*    localEnvironment,
                          CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 	int rc = CCI_SUCCESS;  
   CciNode* sourceNode = cciGetSourceNode(&rc,
                                          connection);
   /*you should now check the rc for unexpected values*/
   CciChar   queueNameAttribute[16];
   cciMbsToUcs(&rc,
               "queueName",
               queueNameAttribute,
               16,
               BIP_DEF_COMP_CCSID);
 /*you should now check the rc for unexpected values*/

   CciChar queueName [512];
   sourceNodeQueueNameLength = cciGetNodeType(&rc,
                                         sourceNode,
                                         queueName,
                                         512);
   /*you should now check the rc for unexpected values*/
   /*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/
 /*sourceNodeQueueNameLength will hold the actual or required size */
관련 태스크
사용자 엑시트 개발
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as36010_