Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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