PROPID_M_DEST_QUEUE_LEN

The PROPID_M_DEST_QUEUE_LEN property indicates the length (in Unicode characters) of the target queue's format name buffer.

Type Indicator
VT_UI4 (or VT_NULL)
PROPVARIANT Field
ulVal
Property Values
Length (in Unicode characters) of the target queue's format name buffer.

Remarks

The PROPID_M_DEST_QUEUE_LEN property is required whenever PROPID_M_DEST_QUEUE is passed as a property in MQReceiveMessage.

On input, PROPID_M_DEST_QUEUE_LEN specifies the length of the format name buffer passed in PROPID_M_DEST_QUEUE. The buffer should be large enough to hold the format name string including the null-terminating character.

On return, this property holds the length (in Unicode characters) of the PROPID_M_DEST_QUEUE format name string including the null-terminating character.

If the buffer is too small, MQReceiveMessage fails and PROPID_M_DEST_QUEUE_LEN can be used to obtain the required buffer length of the format name string.

QuickInfo

  Windows NT: Requires version 4.0 SP3 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in mq.h.
  Import Library: Use mqrt.lib.
  Unicode: Defined only as Unicode.

See Also

MQReceiveMessage, PROPID_M_DEST_QUEUE