C-API 與 C 用戶端執行階段的介面變更

• 新的函數：MQGetDestinationName()

  MQGetDestinationName (const MQDestinationHandle destinationHandle, MQString * destinationName);

  使用此函數取得目標的名稱。傳回的 destinationName 是一個副本，呼叫者需負責呼叫 MQFreeString() 函數以釋放此副本。

  參數

  destinationHandle

  您希望知道其名稱之目標的控點。

  destinationName

  名稱的輸出參數。

  此函數在使用回覆傳送模式時很有用。您可以使用 MQGetMessageReplyTo 函數取得目標 (訊息傳送的目標) 的控點。然後可使用 MQGetDestinationName 取得該目標的名稱。取得目標名稱之後，您可以根據該名稱處理訊息。

• 新的列舉值：MQ_MESSAGE

  新的 MQMessageType (MQ_MESSAGE) 可讓 C 用戶端與其他 Message Queue 用戶端 (C 與 Java) 交換 Message 類型的 JMS 訊息：

  typedef enum _MQMessageType {MQ_TEXT_MESSAGE = 0, MQ_BYTES_MESSAGE = 1, MQ_MESSAGE = 3, MQ_UNSUPPORTED_MESSAGE = 2} MQMessageType;

  MQ_MESSAGE 類型可識別具有標頭與特性但沒有訊息內文的訊息。您可使用 MQCreateMessage() 函數建立此類型的訊息。

• 新連線特性 (MQ_UPDATE_RELEASE_PROPERTY) 指定 Message Queue 已安裝版本的更新發行版本。可使用 MQGetMetaData() 函數取得版本資訊。