Distribution List Format Names

 

Updated: July 19, 2016

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

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 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";  

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 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 onSee
Sending messages to multiple queues using distribution listsDistribution Lists inMultiple-Destination Messaging
Using distribution lists to specify multiple response queuesResponse Queues
Ways to obtain a format nameObtaining Format Names
The elements and syntax of public format namesPublic Format Names
The elements and syntax of private format namesPrivate Format Names
The elements and syntax of multiple-element format namesMultiple-Element Format Names
The elements and syntax of direct format namesDirect Format Names
The elements and syntax of machine and connector format namesMachine and Connector Format Names

Community Additions

ADD
Show: