Connection 物件代表一條應用程式至分配管理系統的作用中連線。
有關 XMS 所定義的 Connection 物件內容清單, 請參閱Connection 內容。
函數 | 說明 |
---|---|
xmsConnClose | 關閉連線。 |
xmsConnCreateSession | 建立階段作業。 |
xmsConnGetClientID | 取得連線的用戶端 ID。 |
xmsConnGetExceptionListener | 取得已向連線登錄之異常狀況接聽器函數和環境定義資料的指標。 |
xmsConnGetMetaData | 取得連線的 meta 資料。 |
xmsConnSetClientID | 設定連線的用戶端 ID。 |
xmsConnSetExceptionListener | 向連線登錄異常狀況接聽器函數和環境定義資料。 |
xmsConnStart | 針對連線啟動或重新啟動送入訊息的遞送。 |
xmsConnStop | 針對連線停止送入訊息的遞送。 |
xmsRC xmsConnCreateSession(xmsHConn connection, xmsBOOL transacted, xmsINT acknowledgeMode, xmsHSess *session, xmsHErrorBlock errorBlock);
若為和分配管理系統間的即時連線, 此值必須是 xmsFALSE。
如果階段作業為交易式, 則會忽略這個參數。如需確認模式的相關資訊,請參閱在階段作業中確認收到訊息。
xmsRC xmsConnGetClientID(xmsHConn connection, xmsCHAR *clientID, xmsINT length, xmsINT *actualLength, xmsHErrorBlock errorBlock);
此函數不適用於和分配管理系統間的即時連線。
如需如何使用此函數的相關資訊, 請參閱會以值形式來傳回字串的 C 函數。
xmsRC xmsConnGetExceptionListener(xmsHConn connection, fpXMS_EXCEPTION_CALLBACK *lsr, xmsCONTEXT *context, xmsHErrorBlock errorBlock);
如需使用異常狀況接聽器函數的相關資訊,請參閱在 C 中使用異常狀況接聽器函數。
xmsRC xmsConnSetClientID(xmsHConn connection, xmsCHAR *clientID, xmsINT length, xmsHErrorBlock errorBlock)
設定連線的用戶端 ID。用戶端 ID 只用來在發佈/訂閱網域中支援延續訂閱, 若在點對點網域中則會被忽略。
如果應用程式呼叫此函數以便設定連線的用戶端 ID 時, 應用程式會在建立連線後旋即執行此作業,然後再對連線執行其他任何作業。如果應用程式在過了該時間點後才試著呼叫此函數, 則函數會傳回 XMS_X_ILLEGAL_STATE_EXCEPTION 異常狀況。
此方法不適用於和分配管理系統間的即時連線。
xmsRC xmsConnSetExceptionListener(xmsHConn connection, fpXMS_EXCEPTION_CALLBACK lsr, xmsCONTEXT context, xmsHErrorBlock errorBlock);
如需使用異常狀況接聽器函數的相關資訊,請參閱在 C 中使用異常狀況接聽器函數。