PROPID_M_APPSPECIFIC (Compact 2013)

  • Article

3/26/2014

This property specifies application-generated information such as single integer values or application-defined message classes.

  • Type Indicator
    VT_UI4 (or VT_NULL)
  • PROPVARIANT Field
    ulVal
  • Property Values
    Unsigned integer. The default is 0.

Remarks

You can use application-specific information to organize different types of messages.

For example, several sending applications might be sending messages to a common queue. If each application uses a different application-specific index, the receiving application can use PROPID_M_APPSPECIFIC to filter out the messages from a single sending application.

To set application-specific information, specify PROPID_M_APPSPECIFIC in the MQMSGPROPS structure and call MQSendMessage.

To retrieve application specific information, specify PROPID_M_APPSPECIFIC in the MQMSGPROPS structure. Then call MQReceiveMessage and examine its returned value.

When specifying PROPID_M_APPSPECIFIC, you can set its Type Indicator to VT_NULL.

When the Type Indicator is set to VT_NULL, MSMQ sets the VT field to the appropriate type indicator.

In addition to application-specific information, you can use the PROPID_M_CORRELATIONID message property for filtering.

Examples

This example shows how PROPID_M_APPSPECIFIC is specified in the MQMSGPROPS structure.

aMsgPropId[i] = PROPID_M_APPSPECIFIC;        // Property ID
aMsgPropVar[i].vt = VT_UI4;                  // Type indicator
aMsgPropVar[i].ulVal = dwAppspecificIndex;   // Value
i++;

Note

OS versions prior to 2.12 require the MSMQ add-on pack.

Requirements

Header

mq.h

See Also

Reference

MSMQ Properties
MQReceiveMessage
MQSendMessage
PROPID_M_CORRELATIONID
MQMSGPROPS