Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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 MQMSGPROPSstructure and call MQSendMessage.

To retrieve application specific information, specify PROPID_M_APPSPECIFIC in the MQMSGPROPSstructure. Then call MQReceiveMessageand 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_CORRELATIONIDmessage property for filtering.

Examples

This example shows how PROPID_M_APPSPECIFIC is specified in the MQMSGPROPSstructure.

Copy Code 
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
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also