변경 시작

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 마지막 갱신 날짜: 5월 12, 2006
as35990_


변경 끝