MSMQMessage (Windows Embedded CE 6.0)
1/6/2010
This object provides access to the properties needed to define a message, plus the methods needed to send the message to its destination queue.
The body of a message can consist of the following:
- A string
- An array of bytes
- A numeric date or currency type that a Variant can contain
- Any persistent COM object that supports IDispatch and IPersist (IPersistStream, IPersistStreamInit, or IPersistStorage)
Methods
The following table lists the methods of the MSMQMessage object.
| Method | Description |
|---|---|
Sends the message to the specified queue. |
Properties
The following table lists the properties of the MSMQMessage object.
| Property | Description |
|---|---|
|
Access: Read/write Data type: Long |
Specifies the type of acknowledgment messages that Message Queuing returns to the administration queue. |
|
Access: Read/write Data type: MSMQQueueInfo |
Specifies the queue used for acknowledgment messages. |
|
Access: Read/write Data type: Long |
Specifies application-generated information for filtering messages. |
|
Access: Read-only Data type: Date Variant |
Provides the time when the message arrived at the queue. |
|
Access: Read/write Data type: Long |
Specifies whether the message should be authenticated when received by the queue. |
|
Access: Read/write Data type: Variant |
Specifies the body of the message. |
|
Access: Read-only Data type: Long |
Provides the size of the message body. |
|
Access: Read-only Data type: Long |
(Superseded by MsgClass.) Provides the type of message. |
|
Access: Read/write Data type: Variant (array of bytes) |
Specifies the correlation identifier of the message. |
|
Access: Read/write Data type: Long |
Specifies how the message is delivered (optimize throughput or recoverability). |
MSMQMessage.DestinationQueueInfo Access: Read-only Data type: MSMQQueueInfo |
Provides the queue where the message resides (the queue the message is sent to). |
|
Access: Read/write Data type: Long |
Specifies the algorithm used to encrypt the message body. |
|
Access: Read/write Data type: Variant (array of bytes) |
(Introduced in MSMQ 2.0.) Specifies additional application-defined information. |
|
Access: Read/write Data type: Long |
Specifies the hash algorithm used when authenticating messages. |
|
Access: Read-only Data type: Variant (array of bytes) |
Provides the MSMQ-generated identifier for the message. |
|
Access: Read-only Data type: Short |
Indicates whether the message was authenticated by MSMQ. |
|
Access: Read/write Data type: Long |
Specifies whether a copy of the message is stored in the computer journal. |
|
Access: Read/write Data type: String |
Specifies an application-defined label for the message. |
MSMQMessage.MaxTimeToReachQueue Access: Read/write Data type: Long |
Specifies how long the message has to reach the queue. |
|
Access: Read/write Data type: Long |
Specifies how long the receiving application has to remove the message from the queue. |
|
Access: Read/write Data type: Long |
Specifies the priority of the message (where it is placed in the queue). |
|
Access: Read/write Data type: Long |
Specifies whether the message is private (encrypted). |
|
Access: Read/write Data type: MSMQQueueInfo |
Specifies the queue for sending responses to the message. |
|
Access: Read/write Data type: Variant (array of bytes) |
Specifies the sender certificate. |
|
Access: Read/write Data type: Variant (array of bytes) |
Identifies the user who sent the message. |
|
Access: Read/write Data type: Long |
Specifies the type of sender identifier found in SenderId. |
|
Access: Read-only Data type: Date Variant |
Provides the date and time that the message was sent. |
|
Access: Read-only Data type: String (GUID format) |
Provides the identifier of the computer where the message originated. |
|
Access: Read/write Data type: Long |
Specifies whether the route of the message is traced. |
Requirements
| Header | mqoai.h |
| Library | mqoa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |