Share via


MSMQMessage.Extension (Compact 2013)

3/26/2014

This property of the MSMQMessage object, introduced in MSMQ 2.0, specifies additional application-defined information that is associated with the message.

This property is used by connector applications.

Type:

Variant (array of bytes)

Run time:

Read/write

Syntax

messageObject.Extension

Parameters

  • messageObject
    Message (MSMQMessage) object that represents the message.

Property Values

Application-defined information.

Remarks

The MSMQMessage.Extension property is used by connector applications to process non-Message Queuing message properties when translating between Message Queuing messages and foreign messages.

It is the responsibility of the sending application, connector application, and the receiving application to understand the content of this property.

Visual Basic arrays

When dimensioning arrays for extension data, always set the lower boundary of the array to 0.

When filling in the extension data, Message Queuing sets the lower boundary of the returned byte-array to 0 regardless of what boundary was set by the application.

The following Microsoft Visual BasicĀ® call always returns 0.

LBound(msg.Extenstion)

Equivalent Function property

When using functions, the extension property of the message can be set and retrieved using the PROPID_M_EXTENSION property.

Requirements

Header

mqoai.h

Library

mqoa.lib

See Also

Reference

MSMQMessage