MSMQMessage.AppSpecific
Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista
The AppSpecific property of the MSMQMessage object specifies application-generated information, such as single integer values or application-defined message classes.
Data type: | Long |
Run-time access: | Read/write |
Property AppSpecific As Long
Property Value
A Long containing application-defined information.
Remarks
The AppSpecific property can be used to identify a single message or set of messages. For example, the receiving application can search a queue for all messages that have the same application specific information.
If the sending application sets AppSpecific to a negative value, receiving applications that are using the API calls to read messages will read these values as Unsigned Long values.
Another message property that can be used to pass application-defined information is MSMQMessage.CorrelationId.
Equivalent API Function Property
With API function calls, the equivalent property is PROPID_M_APPSPECIFIC.
Example Code
The following example is included in Using Message Queuing.
For an Example of | See |
---|---|
Retrieving messages based on application-specific information | Visual Basic Code Example: Application-Specific Filters |
Requirements
Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later
Windows 95/98/Me: Included in Windows 95 and later.
Header: Declared in Mqoai.h.
Library: Use Mqoa.lib