对 C-API 和 C 客户端运行时环境的接口更改

• 新函数：MQGetDestinationName()

  MQGetDestinationName (const MQDestinationHandle destinationHandle, MQString * destinationName);

  使用此函数可以获取目的地的名称。返回的 destinationName 是一个副本，调用方通过调用 MQFreeString() 函数来负责释放该副本。

  参数

  destinationHandle

  要获取其名称的目的地的句柄。

  destinationName

  名称的输出参数。

  使用回复模式时，此函数会非常有用。可以使用 MQGetMessageReplyTo 函数获取要将消息发送到的目的地的句柄。然后可以使用 MQGetDestinationName 获取该目的地的名称。获取目的地名称之后，便可以根据此名称来处理消息。

• 新枚举值：MQ_MESSAGE

  新的 MQMessageType (MQ_MESSAGE) 允许 C 客户端与其他使用 C 和 Java 的 Message Queue 客户端交换 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() 函数可获取版本信息。