Distribution List 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
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):
To specify multiple destinations in the PROPID_M_DEST_FORMAT_NAME or MSMQMessage.Destination property of a message when sending messages (distribution lists cannot be used read messages in a queue).
To specify multiple response queues in PROPID_M_RESP_FORMAT_NAME or MSMQMessage.ResponseDestination when requesting response messages.
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 |