변경 시작

cciGetNodeAttribute

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

구문

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

매개변수

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

    제공된 버퍼가 노드 유형 값을 포함할 만큼 크지 않습니다.

node(입력)
노드에 대한 핸들입니다.
name(입력)
이 매개변수는 조회되는 노드 속성 이름을 지정하는 CciChar의 널(Null) 종료 문자열에 대한 포인터입니다.
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 마지막 갱신 날짜: 5월 12, 2006
as36010_


변경 끝