MSMQMessage (Windows CE 5.0)
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 |
|---|---|
| Send | Sends the message to the specified queue. |
Properties
The following table lists the properties of the MSMQMessage object.
| Property | Description |
|---|---|
| Ack
Access: Read/write Data type: Long |
Specifies the type of acknowledgment messages that Message Queuing returns to the administration queue. |
| AdminQueueInfo
Access: Read/write Data type: MSMQQueueInfo |
Specifies the queue used for acknowledgment messages. |
| AppSpecific
Access: Read/write Data type: Long |
Specifies application-generated information for filtering messages. |
| ArrivedTime
Access: Read-only Data type: Date Variant |
Provides the time when the message arrived at the queue. |
| AuthLevel
Access: Read/write Data type: Long |
Specifies whether the message should be authenticated when received by the queue. |
| Body
Access: Read/write Data type: Variant |
Specifies the body of the message. |
| BodyLength
Access: Read-only Data type: Long |
Provides the size of the message body. |
| Class
Access: Read-only Data type: Long |
(Superseded by MsgClass.) Provides the type of message. |
| CorrelationId
Access: Read/write Data type: Variant (array of bytes) |
Specifies the correlation identifier of the message. |
| Delivery
Access: Read/write Data type: Long |
Specifies how the message is delivered (optimize throughput or recoverability). |
| DestinationQueueInfo
Access: Read-only Data type: MSMQQueueInfo |
Provides the queue where the message resides (the queue the message is sent to). |
| EncryptAlgorithm
Access: Read/write Data type: Long |
Specifies the algorithm used to encrypt the message body. |
| Extension
Access: Read/write Data type: Variant (array of bytes) |
(Introduced in MSMQ 2.0.) Specifies additional application-defined information. |
| HashAlgorithm
Access: Read/write Data type: Long |
Specifies the hash algorithm used when authenticating messages. |
| Id
Access: Read-only Data type: Variant (array of bytes) |
Provides the MSMQ-generated identifier for the message. |
| IsAuthenticated
Access: Read-only Data type: Short |
Indicates whether the message was authenticated by MSMQ. |
| Journal
Access: Read/write Data type: Long |
Specifies whether a copy of the message is stored in the computer journal. |
| Label
Access: Read/write Data type: String |
Specifies an application-defined label for the message. |
| MaxTimeToReachQueue
Access: Read/write Data type: Long |
Specifies how long the message has to reach the queue. |
| MaxTimeToReceive
Access: Read/write Data type: Long |
Specifies how long the receiving application has to remove the message from the queue. |
| Priority
Access: Read/write Data type: Long |
Specifies the priority of the message (where it is placed in the queue). |
| PrivLevel
Access: Read/write Data type: Long |
Specifies whether the message is private (encrypted). |
| ResponseQueueInfo
Access: Read/write Data type: MSMQQueueInfo |
Specifies the queue for sending responses to the message. |
| SenderCertificate
Access: Read/write Data type: Variant (array of bytes) |
Specifies the sender certificate. |
| SenderId
Access: Read/write Data type: Variant (array of bytes) |
Identifies the user who sent the message. |
| SenderIdType
Access: Read/write Data type: Long |
Specifies the type of sender identifier found in SenderId. |
| SentTime
Access: Read-only Data type: Date Variant |
Provides the date and time that the message was sent. |
| SourceMachineGuid
Access: Read-only Data type: String (GUID format) |
Provides the identifier of the computer where the message originated. |
| Trace
Access: Read/write Data type: Long |
Specifies whether the route of the message is traced. |
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Mqoai.h.
Link Library: Mqoa.lib.
Send Feedback on this topic to the authors