在 3.7 发行版中已经对 C-API 进行了更改:这些更改包括一个新函数、一个新消息类型和一个新连接属性。
新函数:MQGetDestinationName()
MQGetDestinationName (const MQDestinationHandle destinationHandle,
MQString * destinationName);
|
使用此函数可获取目标名称。返回的 destinationName 是一个副本,调用程序通过调用 MQFreeString() 函数释放此副本。
参数
要了解其名称的目标的句柄。
名称的输出参数。
使用回复模式时,此函数会非常有用。可以使用 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() 函数可获取版本信息。