ObjectString (MQCHARV)

这是要使用的长对象名。

ObjectString 用于构成完整主题名称。

可以从两个不同的字段构建完整主题名称: ObjectNameObjectString。 有关如何使用这两个字段的详细信息,请参阅 组合主题字符串

ObjectString 的最大长度为 10240。

如果未正确指定 ObjectString ,那么根据如何使用 MQCHARV 结构的描述,或者如果它超过最大长度,那么调用将失败,原因码为 MQRC_OBJECT_STRING_ERROR。

这是一个输入字段。 此结构中字段的初始值与 MQCHARV 结构中的初始值相同。

如果 ObjectString 中存在通配符,那么可以使用 MQSD 的 "选项" 字段中指定的通配符选项来控制这些通配符的解释。

从使用 MQSO_RESUME 选项的 MQSUB 调用返回时,此字段保持不变。 如果提供了缓冲区,那么将在 ResObjectString 字段中返回所使用的完整主题名称。

如果使用 MQSO_ALTER 选项更改现有预订,那么无法更改预订的主题对象的长名称。 可以省略此字段和 ObjectName 字段。 如果提供了它们,那么它们必须解析为相同的完整主题名称,否则调用将失败并返回 MQRC_TOPIC_NOT_ALTERABLE。