次の方法で共有


MSMQMessage.Send (Compact 2013)

3/26/2014

This method sends a message to one or more destination queues.

Syntax

HRESULT.Send( 
  MSMQQueue* DestinationQueue, 
  VARIANT* Transaction
)

Parameters

  • DestinationQueue
    Reference to an MSMQDestination or MSMQQueueInfo object.
  • Transaction
    Message to send.

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

Each Message Queuing message can have no more than 4 MB of data.

To get the handle of a queue, use the MSMQQueue.Handle property of the queue.

To save a copy of the message in a computer journal, set MSMQMessage.Journal to MQMSG_JOURNAL.

Messages that do not reach their destination can be sent to a dead-letter queue by setting the message's MSMQMessage.Journal property to MQMSG_DEADLETTER.

When sending messages using Send, you cannot specify the type of message body included in the message. Message Queuing determines the body type and sets the message body type property for you. (The body type property of the message can be accessed only with Message Queuing functions).

Sending Message to Multiple Destinations

To send a message to multiple destinations (introduced in MSMQ 3.0), the DestinationQueue parameter must reference an MSMQDestination object.

Responding to Messages

The sending application can request a response by providing the format name of a response queue when it sends the message. The format name is specified in the MSMQMessage.ResponseQueueInfo property when the message is sent.

Requirements

Header

mqoai.h

Library

mqoa.lib

See Also

Reference

MSMQMessage
MSMQMessage.Body
MSMQMessage.Journal
MSMQMessage.Label
MSMQQueue.Close
MSMQQueue.Handle
MSMQQueue
MSMQQueueInfo.Create
MSMQQueueInfo.Open
MSMQQueueInfo.PathName
MSMQQueueInfo