cniIsTerminalAttached

커넥터가 터미널을 다른 노드에 연결했는지 점검합니다. 지정된 터미널 오브젝트가 다른 메시지 플로우 노드의 하나 이상의 터미널에 연결되었는지 여부를 지정하는 정수 값을 리턴합니다. 이 값을 사용하여 메시지가 터미널로 전달될 수 있는지 여부를 테스트할 수 있습니다. 그러나, cniPropagate 유틸리티 함수로 메시지를 전달하기 전에 이 함수를 호출할 필요는 없습니다. 노드는 cniIsTerminalAttached 함수를 사용하여 터미널이 연결되지 않았을 때 작동을 수정할 수 있습니다.

구문

int cniIsTerminalAttached(
    int*                   returnCode,
    CciTerminal*  terminalObject);

매개변수

returnCode
함수의 리턴 코드(출력).
가능한 리턴 코드는 다음과 같습니다.
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_TERMINAL_OBJECT
terminalObject
연결된 커넥터에 대해 점검될 입력 터미널 또는 출력 터미널의 주소(입력). 주소는 cniCreateOutputTerminal로부터 리턴됩니다.

리턴 값

  • 커넥터가 터미널을 다른 노드에 연결한 경우, 1 값이 리턴됩니다.
  • 터미널이 연결되지 않았거나 장애가 발생할 경우, 0 값이 리턴됩니다.
  • 장애가 발생할 경우, returnCode 매개변수 값은 오류의 이유를 표시합니다.

    if (terminalObject) {
        if (cniIsTerminalAttached(&rc, terminalObject)) {
            if (rc == CCI_SUCCESS) {
              retvalue = cniPropagate(
                                                                                                  &rc, 
                                                             terminalObject, 
                                                             destinationList, 
                                                             exceptionList, 
                                                                message);
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as07550_