有關 XMS 所定義的 Session 內容清單, 請參閱Session 內容。
函數 | 說明 |
---|---|
xmsSessClose | 關閉階段作業。 |
xmsSessCommit | 確定現行交易中所有已處理的訊息。 |
xmsSessCreateBrowser | 為指定的佇列建立佇列瀏覽器。 |
xmsSessCreateBrowserSelector | 使用訊息選取器為指定的佇列建立佇列瀏覽器。 |
xmsSessCreateBytesMessage | 建立位元組訊息。 |
xmsSessCreateConsumer | 為指定的目的地建立訊息使用端。 |
xmsSessCreateConsumerSelector | 使用訊息選取器為指定的目的地建立訊息使用端。 |
xmsSessCreateConsumerSelectorLocal | 使用訊息選取器為指定的目的地建立訊息使用端,如果目的地為一個主題, 並指定訊息使用端是否接收其本身連線所發佈的訊息。 |
xmsSessCreateDurableSubscriber | 為指定的主題建立延續訂閱者。 |
xmsSessCreateDurableSubscriberSelector | 使用訊息選取器為指定的主題建立延續訂閱者, 並指定延續訂閱者是否接收其本身連線所發佈的訊息。 |
xmsSessCreateMapMessage | 建立對映訊息。 |
xmsSessCreateMessage | 建立一則沒有主體的訊息。 |
xmsSessCreateObjectMessage | 建立物件訊息。 |
xmsSessCreateProducer | 建立訊息生產者以傳送訊息給指定的目的地。 |
xmsSessCreateStreamMessage | 建立串流訊息。 |
xmsSessCreateTextMessage | 建立一則空主體的文字訊息。 |
xmsSessCreateTextMessageInit | 建立文字訊息,並使用指定文字來起始設定其主體。 |
xmsSessGetAcknowledgeMode | 取得階段作業的確認模式。 |
xmsSessGetTransacted | 判斷階段作業是否為交易式。 |
xmsSessRecover | 回復 (Recover) 階段作業。 |
xmsSessRollback | 回(Rollback)復現行交易中所有已處理的訊息。 |
xmsSessUnsubscribe | 刪除延續訂閱。 |
xmsRC xmsSessClose(xmsHSess *session, xmsHErrorBlock errorBlock);
關閉階段作業。如果階段作業為交易式, 則會回復任何進行中的交易。
所有和階段作業相依的物件都會刪除。如需哪些物件會被刪除的相關資訊, 請參閱刪除物件。
如果應用程式試著關閉已關閉的階段作業, 則會忽略該呼叫。
xmsRC xmsSessCreateBrowser(xmsHSess session, xmsHDest queue, xmsHQueueBrowser *browser xmsHErrorBlock errorBlock);
xmsRC xmsSessCreateBrowserSelector(xmsHSess session, xmsHDest queue, xmsCHAR *messageSelector, xmsINT length, xmsHQueueBrowser *browser xmsHErrorBlock errorBlock);
空值或空字串值表示佇列瀏覽器沒有訊息選取器。
xmsRC xmsSessCreateConsumer(xmsHSess session, xmsHDest destination, xmsHMsgConsumer *consumer, xmsHErrorBlock errorBlock);
xmsRC xmsSessCreateConsumerSelector(xmsHSess session, xmsHDest destination, xmsCHAR *messageSelector, xmsINT length, xmsHMsgConsumer *consumer, xmsHErrorBlock errorBlock);
空值或空字串值表示訊息使用端沒有訊息選取器。
xmsRC xmsSessCreateConsumerSelectorLocal(xmsHSess session, xmsHDest destination, xmsCHAR *messageSelector, xmsINT length, xmsBOOL noLocal, xmsHMsgConsumer *consumer, xmsHErrorBlock errorBlock);
使用訊息選取器為指定的目的地建立訊息使用端,如果目的地為一個主題, 並指定訊息使用端是否接收其本身連線所發佈的訊息。
空值或空字串值表示訊息使用端沒有訊息選取器。
xmsRC xmsSessCreateDurableSubscriber(xmsHSess session, xmsHDest topic, xmsCHAR *subscriptionName xmsHMsgConsumer *subscriber, xmsHErrorBlock errorBlock);
此函數不適用於和分配管理系統間的即時連線。
如需延續訂閱者的相關資訊, 請參閱延續訂閱者。
xmsRC xmsSessCreateDurableSubscriberSelector(xmsHSess session, xmsHDest topic, xmsCHAR *subscriptionName xmsCHAR *messageSelector, xmsINT length, xmsBOOL noLocal, xmsHMsgConsumer *subscriber, xmsHErrorBlock errorBlock);
使用訊息選取器為指定的主題建立延續訂閱者, 並指定延續訂閱者是否接收其本身連線所發佈的訊息。
此函數不適用於和分配管理系統間的即時連線。
如需延續訂閱者的相關資訊, 請參閱延續訂閱者。
空值或空字串值表示延續訂閱者沒有訊息選取器。
xmsRC xmsSessCreateProducer(xmsHSess session, xmsHDest destination, xmsHMsgProducer *producer, xmsHErrorBlock errorBlock);
如果您指定空值控點,則會建立一個沒有目的地的訊息生產者。在此情況下, 應用程式每當使用訊息生產者來傳送訊息時,即必須指定一個目的地。
xmsRC xmsSessCreateTextMessageInit(xmsHSess session, xmsCHAR *text xmsINT length xmsHMsg *message, xmsHErrorBlock errorBlock);
xmsRC xmsSessGetAcknowledgeMode(xmsHSess session, xmsINT *acknowledgeMode, xmsHErrorBlock errorBlock);
交易式階段作業沒有確認模式。
如需確認模式的相關資訊,請參閱在階段作業中確認收到訊息。
xmsRC xmsSessRecover(xmsHSess session, xmsHErrorBlock errorBlock);
回復 (Recover) 階段作業。訊息遞送會停止, 然後使用最舊的未確認訊息重新啟動。
階段作業不得為交易式階段作業。
如需回復 (Recover) 階段作業的相關資訊, 請參閱在階段作業中確認收到訊息。
xmsRC xmsSessUnsubscribe(xmsHSess session, xmsCHAR *subscriptionName, xmsHErrorBlock errorBlock);
刪除延續訂閱。傳訊伺服器會刪除它所維護的延續訂閱記錄, 且不會傳送任何進一步的訊息給延續訂閱者。
此函數不適用於和分配管理系統間的即時連線。