변경 시작

cciGetTargetTerminalName

이 함수는 지정된 연결에 대한 대상 노드의 입력 터미널 이름을 리턴합니다.

구문

CciSize cciGetTargetTerminalName (int* returnCode,
CciConnection* connection,
CciChar* value,
CciSize         length);

매개변수

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

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

connection(연결)
두 노드 사이의 연결에 대한 핸들입니다.
value(출력)
터미널 이름 값을 포함하도록 호출자가 할당하는 버퍼의 주소입니다.
length
호출자가 할당하는 버퍼의 길이로, CciChars 형식입니다.

리턴 값

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

void myPropagatedMessageCallback(
CciDataContext* userContext,
  CciMessage*        message,
CciMessage* localEnvironment,
  CciMessage* exceptionList,          
CciMessage* environment,
CciConnection* connection){
  int          rc = CCI_SUCCESS;
CciChar targetTerminalName[initialStringBufferLength];
cciGetTargetTerminalName(&rc,
connection,
targetTerminalName,
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
as36030_


변경 끝