cciGetNodeName

이 함수는 지정된 노드의 이름을 리턴합니다.

구문

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

매개변수

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

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

node(입력)
이 매개변수는 노드의 핸들입니다.
value(출력)
노드의 이름을 저장하도록 호출자가 할당하는 버퍼의 주소
length
호출자가 할당하는 버퍼의 길이(CciChars 단위)

리턴 값

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

void myPropagatedMessageCallback(
                          CciMessage*        message,
                        CciMessage*    localEnvironment,
                          CciMessage* exceptionList,
                        CciMessage*    environment,
                        CciConnection* connection){
 
	int rc = CCI_SUCCESS;
   CciNode* targetNode = cciGetTargetNode(&rc,
                                          connection);

 

   CciChar targetNodeName [initialStringBufferLength];
   targetNodeNameLength = cciGetNodeName(&rc,
                                         targetNode,
                                         targetNodeName,
                                         initialStringBufferLength);
   /*you should now check the rc for unexpected values*/
   /*if rc is CCI_BUFFER_TOO_SMALL then you should resize and retry*/

}  
관련 태스크
사용자 엑시트 개발
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as35990_