cciGetSourceTerminalName

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

구문

CciSize  cciGetSourceTerminalName (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 sourceTerminalName[initialStringBufferLength];
   cciGetSourceTerminalName(&rc,
                            connection,
                            sourceTerminalName,
                            initialStringBufferLength);
}
관련 태스크
사용자 엑시트 개발
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as36020_