Connection 物件代表一條應用程式至分配管理系統的作用中連線。
xms::PropertyContext | +----xms::Connection
有關 XMS 所定義的 Connection 物件內容清單, 請參閱Connection 內容。
方法 | 說明 |
---|---|
close | 關閉連線。 |
createSession | 建立階段作業。 |
getClientID | 取得連線的用戶端 ID。 |
getExceptionListener | 取得已向連線登錄之異常狀況接聽器的指標。 |
getHandle | 取得 C 應用程式在存取連線時所要使用的控點。 |
getMetaData | 取得連線的 meta 資料。 |
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 時, 應用程式會在建立連線後旋即執行此作業,然後再對連線執行其他任何作業。如果應用程式在過了該時間點後才試著呼叫此方法, 則此方法會擲出 XMS_X_ILLEGAL_STATE_EXCEPTION 異常狀況。
此方法不適用於和分配管理系統間的即時連線。
xmsVOID setExceptionListener(const ExceptionListener *lsr);
如需使用異常狀況接聽器的相關資訊, 請參閱在 C++ 中使用異常狀況接聽器。
若有異常狀況接聽器已向連線登錄, 您可以改指定一個空值指標,以取消登錄。