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

在 3.7 发行版中已经对 C-API 进行了更改：这些更改包括一个新函数、一个新消息类型和一个新连接属性。

• 新函数：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() 函数可获取版本信息。