有關 XMS 所定義的 MessageProducer 物件內容清單, 請參閱MessageProducer 內容。
函數 | 說明 |
---|---|
xmsMsgProducerClose | 關閉訊息生產者。 |
xmsMsgProducerGetDeliveryMode | 取得訊息生產者所送訊息的預設遞送模式。 |
xmsMsgProducerGetDestination | 取得訊息生產者的目的地。 |
xmsMsgProducerGetDisableMsgID | 取得接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID 的指示。 |
xmsMsgProducerGetDisableMsgTS | 取得接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記的指示。 |
xmsMsgProducerGetPriority | 取得訊息生產者所送訊息的預設優先順序。 |
xmsMsgProducerGetTimeToLive | 取得訊息的預設存在時間長度,一旦超過即算到期。 |
xmsMsgProducerSend | 傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。 |
xmsMsgProducerSendDest | 如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。 |
xmsMsgProducerSendDestWithAttr | 如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。 |
xmsMsgProducerSendWithAttr | 傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。 |
xmsMsgProducerSetDeliveryMode | 設定訊息生產者所送訊息的預設遞送模式。 |
xmsMsgProducerSetDisableMsgID | 指出接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID。 |
xmsMsgProducerSetDisableMsgTS | 指出接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記。 |
xmsMsgProducerSetPriority | 設定訊息生產者所送訊息的預設優先順序。 |
xmsMsgProducerSetTimeToLive | 設定訊息的預設存在時間長度,一旦超過即算到期。 |
xmsRC xmsMsgProducerGetDeliveryMode(xmsHMsgProducer producer, xmsINT *deliveryMode, xmsHErrorBlock errorBlock);
若為和分配管理系統間的即時連線, 此值固定是 XMSC_DELIVERY_NON_PERSISTENT。
xmsRC xmsMsgProducerGetDisableMsgID(xmsHMsgProducer producer, xmsBOOL *msgIDDisabled, xmsHErrorBlock errorBlock);
取得接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID 的指示。
xmsRC xmsMsgProducerGetDisableMsgTS(xmsHMsgProducer producer, xmsBOOL *timeStampDisabled, xmsHErrorBlock errorBlock);
取得接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記的指示。
xmsRC xmsMsgProducerGetTimeToLive(xmsHMsgProducer producer, xmsLONG *timeToLive, xmsHErrorBlock errorBlock);
取得訊息的預設存在時間長度,一旦超過即算到期。 時間是從訊息生產者送出訊息開始計算。
xmsRC xmsMsgProducerSend(xmsHMsgProducer producer, xmsHMsg message, xmsHErrorBlock errorBlock);
傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。
xmsRC xmsMsgProducerSendDest(xmsHMsgProducer producer, xmsHDest destination, xmsHMsg message, xmsHErrorBlock errorBlock);
如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用訊息生產者的預設遞送模式、優先順序和存活時間下傳送訊息。
一般而言, 您會在建立訊息生產者時指定一個目的地, 如果您沒有指定,則每當傳送訊息時您都必須指定一個目的地。
xmsRC xmsMsgProducerSendDestWithAttr(xmsHMsgProducer producer, xmsHDest destination, xmsHMsg message, xmsINT deliveryMode, xmsINT priority, xmsLONG timeToLive, xmsHErrorBlock errorBlock);
如果您所用的訊息生產者在當初建立時並未指定目的地, 則會將訊息傳給指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。
一般而言, 您會在建立訊息生產者時指定一個目的地, 如果您沒有指定,則每當傳送訊息時您都必須指定一個目的地。
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
xmsRC xmsMsgProducerSendWithAttr(xmsHMsgProducer producer, xmsHMsg message, xmsINT deliveryMode, xmsINT priority, xmsLONG timeToLive, xmsHErrorBlock errorBlock);
傳送訊息給當初建立訊息生產者時所指定的目的地。這會在使用指定的遞送模式、優先順序和存活時間下傳送訊息。
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
xmsRC xmsMsgProducerSetDeliveryMode(xmsHMsgProducer producer, xmsINT deliveryMode, xmsHErrorBlock errorBlock);
若為和分配管理系統間的即時連線, 此值必須是 XMSC_DELIVERY_NON_PERSISTENT。
預設值為 XMSC_DELIVERY_PERSISTENT,但如果是和分配管理系統間的即時連線, 則預設值會是 XMSC_DELIVERY_NON_PERSISTENT。
xmsRC xmsMsgProducerSetDisableMsgID(xmsHMsgProducer producer, xmsBOOL msgIDDisabled, xmsHErrorBlock errorBlock);
指出接收端應用程式是否要求訊息生產者所送訊息中需包含訊息 ID。
若為和佇列管理程式間的連線, 或和分配管理系統間的即時連線,則會忽略此旗標。若為和服務整合匯流排間的連線,則會採用此旗標。
xmsRC xmsMsgProducerSetDisableMsgTS(xmsHMsgProducer producer, xmsBOOL timeStampDisabled, xmsHErrorBlock errorBlock);
指出接收端應用程式是否要求訊息生產者所送訊息中需包含時間戳記。
若為和分配管理系統間的即時連線, 則會忽略此旗標。若為和佇列管理程式間的連線或是和服務整合匯流排間的連線,則會採用此旗標。
xmsRC xmsMsgProducerSetPriority(xmsHMsgProducer producer, xmsINT priority, xmsHErrorBlock errorBlock);
若為和分配管理系統間的即時連線, 則會忽略訊息的優先順序。
xmsRC xmsMsgProducerSetTimeToLive(xmsHMsgProducer producer, xmsLONG timeToLive, xmsHErrorBlock errorBlock);
設定訊息的預設存在時間長度,一旦超過即算到期。 時間是從訊息生產者送出訊息開始計算。