MSMQMessage.AppSpecific (Windows Embedded CE 6.0)
1/6/2010
This property specifies application-generated information, such as single integer values or application-defined message classes.
Syntax
HRESULT get_AppSpecific(
long* plAppSpecific
);
HRESULT put_AppSpecific(
long plAppSpecific
);
Parameters
- plAppSpecific or plAppSpecific
Application-generated information such as single integer values or defined message classes.
Return Value
The following table describes the common return values.
| Value | Description |
|---|---|
S_OK |
Success |
E_INVALIDARG |
One or more arguments are invalid |
E_NOTIMPL |
The function contains no implementation |
E_OUTOFMEMORY |
Out of memory |
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.
.gif "Ee498926.collapse(en-US,WinEmbedded.60).gif")
Equivalent Function Property
When using function calls, the application specific information of the message can be set and retrieved using the PROPID_M_APPSPECIFIC message property.
Requirements
| Header | mqoai.h |
| Library | mqoa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |