Connection 오브젝트는 브로커에 대한 응용프로그램의 활성화된 연결을 표시합니다.
xms::PropertyContext | +----xms::Connection
Connection 오브젝트의 XMS 정의 등록 정보 목록은 Connection 등록 정보을 참조하십시오.
메소드 | 설명 |
---|---|
Close | 연결을 닫습니다. |
createSession | 세션을 작성합니다. |
getClientID | 연결에 대한 클라이언트 ID를 가져옵니다. |
getExceptionListener | 연결에 등록된 예외 리스너로 포인터를 가져옵니다. |
getHandle | C 응용프로그램이 연결에 액세스하기 위해 사용할 핸들을 가져옵니다. |
getMetaData | 연결에 대한 메타데이터를 가져옵니다. |
isNull | Connection 오브젝트가 널 오브젝트인지 여부를 판별합니다. |
setClientID | 연결에 대한 클라이언트 ID를 설정합니다. |
setExceptionListener | 예외 리스너를 연결에 등록합니다. |
start | 연결에 대한 수신 메시지 전달을 시작 또는 재시작합니다. |
stop | 연결에 대한 수신 메시지 전달을 중지합니다. |
Session createSession(const xmsBOOL transacted, const xmsINT acknowledgeMode);
브로커에 대한 실시간 연결의 경우 값이 xmsFALSE여야 합니다.
트랜잭트된 세션일 경우 이 매개변수는 무시됩니다. 수신확인 모드에 대한 자세한 정보는 세션의 메시지 수신확인을 참조하십시오.
ExceptionListener * getExceptionListener() const;
예외 리스너 사용에 대한 자세한 정보는 C++에서 예외 리스너 사용을 참조하십시오.
xmsVOID setClientID(const String & clientID);
연결에 대한 클라이언트 ID를 설정합니다. 클라이언트 ID는 공개/등록 도메인에서 지속 가능한 등록을 지원하는 데만 사용되며 지점간 도메인에서는 무시됩니다.
응용프로그램이 연결에 대한 클라이언트 ID를 호출할 경우 응용프로그램은 연결이 작성된 직후 즉, 연결에서 다른 작업을 수행하기 전에 클라이언트 ID를 설정해야 합니다. 이 시점 이후에 응용프로그램에서 메소드를 호출하려고 하면 XMS_X_ILLEGAL_STATE_EXCEPTION 예외가 발생합니다.
이 메소드는 실시간 브로커 연결에는 유효하지 않습니다.
xmsVOID setExceptionListener(const ExceptionListener *lsr);
예외 리스너 사용에 대한 자세한 정보는 C++에서 예외 리스너 사용을 참조하십시오.
예외 리스너가 이미 연결에 등록되어 있을 경우 대신 널 포인터를 지정하여 등록을 취소할 수 있습니다.