Distribution List Format Names

Distribution list format names (introduced in MSMQ 3.0) are used to reference distribution lists stored in Active Directory Domain Services (AD DS). Distribution lists can be used when performing the following operations while online (distribution lists cannot be used if there is no connection to AD DS):

Distribution lists can contain references to public queues, queue aliases (introduced in MSMQ 3.0), and other distribution lists (private queues and URL-named queues can only be referenced through queue aliases).

Distribution List Format Name Syntax

Distribution list format names contain the string "DL=" followed by the distribution list identifier. The distribution list identifier (GUID) can be found in the objectGUID attribute of the distribution list group object using ADSI Edit. The following is the general form of the format names used to reference a distribution list:

DL=DistributionListGUID.

The following line of code is an example of a distribution list format name string (note that the format name string is a null-terminated Unicode string).

LPWSTR wsz = L"DL=ae0c5671-f190-12ce-ae10-00dd0114290f";

Creating and Maintaining Distribution Lists

Distribution lists can be created and maintained programmatically using the methods provided by the IADsGroup interface. MSMQ 3.0 provides a read-only ADs path queue property (PROPID_Q_ADS_PATH or MSMQQueueInfo.ADsPath) that can be used to obtain the ADs path of a queue when creating or maintaining a distribution list.

When queues are added to an AD DS distribution list, Message Queuing will not send messages to the additional queues by means of an open handle created for the distribution list or an MSMQDestination object opened for the distribution list before the new queues were added. Your application must create a new queue handle with the distribution list format name or close and reopen the MSMQDestination object (or open a new object) before sending messages to the additional queues.

Distribution Lists and Multiple-Element Format Names

Distribution lists and multiple-element format names both reference multiple destinations. The difference between them is that distribution lists are public lists stored in AD DS and multiple-element format names are private lists that must be created and maintained by the application.

For information on See

Sending messages to multiple queues using distribution lists

Distribution Lists inMultiple-Destination Messaging

Using distribution lists to specify multiple response queues

Response Queues

Ways to obtain a format name

Obtaining Format Names

The elements and syntax of public format names

Public Format Names

The elements and syntax of private format names

Private Format Names

The elements and syntax of multiple-element format names

Multiple-Element Format Names

The elements and syntax of direct format names

Direct Format Names

The elements and syntax of machine and connector format names

Machine and Connector Format Names

Show:
© 2014 Microsoft