ReturnedLength (MQLONG)

这是队列管理器在 Buffer 参数中设置为 MQGET 调用返回的消息数据的长度 (以字节计) 的输出字段。 如果队列管理器不支持此功能，那么 ReturnedLength 将设置为值 MQRL_UNDEFINED。

在编码或字符集之间转换消息时，消息数据有时会更改大小。 从 MQGET 调用返回时:
  • 如果 ReturnedLength 不是 MQRL_UNDEFINED ，那么返回的消息数据的字节数由 ReturnedLength给出。
  • 如果 ReturnedLength 具有值 MQRL_UNDEFINED ，那么返回的消息数据的字节数通常由 BufferLength 和 DataLength中的较小者提供，但如果 MQGET 调用完成且原因码为 MQRC_TRUNCATED_MSG_RECEIVED ，那么可以 小于 此值。 如果发生此情况，那么 Buffer 参数中的无意义字节将设置为 null。
定义了以下特殊值:
MQRL_UNDEFINED
未定义返回的数据的长度。

在 z/OS®上，针对 ReturnedLength 字段返回的值始终为 MQRL_UNDEFINED。

此字段的初始值为 MQRL_UNDEFINED。 如果 Version 小于 MQGMO_VERSION_3，那么将忽略此字段。