Multiple Destinations: Multiple-element format names


Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

Multiple-element format names are private lists of destination queues. A multiple-element format name is created by concatenating any number of public format names, private format names, direct format names, including direct format names for sending messages over HTTP/HTTPS, multicast address format names, and distribution list format names.

A list of response queues can be specified in a message by setting the PROPID_M_RESP_FORMAT_NAME or MSMQMessage.ResponseDestination property to a multiple-element format name.

Before sending a message to the queues specified in a multiple-element format name, an application calls MQOpenQueue to open the set of destination queues with send access using a multiple-element format name or sets the MSMQDestination.FormatName property of an MSMQDestination object using a multiple-element format name.

When applications send messages to a multiple-element format name, Message Queuing specifies the format name used to send the messages in the PROPID_M_DEST_FORMAT_NAME or MSMQMessage.Destination property and the destination queue of the particular copy in the PROPID_M_DEST_QUEUE or MSMQMessage.DestinationQueueInfo property.

When authentication is requested, messages sent to a multiple-element format name are signed using a multiple-destination digital signature. For more information on the digital signatures used by Message Queuing, see Digital Signatures.

You can send transactional messages to either a distribution list or a multiple-element format name. However, MQSendMessage will return MQ_ERROR_INVALID_PARAMETER if you try to do so with a PROPID_M_JOURNAL property of MQMSG_DEADLETTER (that is, with negative source journaling enabled). To correct this, either send the message to a single queue at a time, or disable negative source journaling.

When private (encrypted) messages are sent to a multiple-element format name that consists of only public and private format names, Message Queuing can encrypt the message body. However, if the multiple-element format name contains a direct format name, your application must encrypt the message body. For more information on sending private messages, see Message Encryption.

For information on the syntax of multiple-element format names, see Multiple-Element Format Names.

See Also

Multiple-Destination Messaging