Private 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
Private format names are used to reference private queues. They are used to perform the following operations:
To open a private queue to send messages and request routing. A private queue can be opened with a private or direct format name. When a private format name is used, Message Queuing uses its internal routing algorithm to define the route to the destination queue. When a direct format name is used, the message is sent directly to the queue.
To open a private queue to read messages.
To retrieve and set the properties of a private queue.
To retrieve or set the security descriptor of a private queue.
When Message Queuing detects a private format name, it does not refer to the directory service for information about the queue. However, it does use the directory service to convert the GUID of the host computer to a computer name for routing and other purposes. Private format names cannot be used on computers operating in workgroup mode.
Private Format Name Syntax
Private format names contain the string "Private=" followed by the globally unique identifier (GUID) of the computer where the queue is registered and a hexadecimal number that identifies the queue. The following is the general form of the private format names used to reference a private queue and its associated queue journal:
PRIVATE=ComputerGUID\QueueNumber *Private queues.
PRIVATE=ComputerGUID\QueueNumber;JOURNAL *Private queue journals.
The following line of code is an example of a private format name string (note that the format name string is a null-terminated Unicode string).
LPWSTR wsz = L"PRIVATE=ae0c5671-f190-12ce-ae10-00dd0114290f\0000000d";
Specifying Multiple Queues
Private format names can be used in multiple-element format names. (A private format name cannot be explicitly referenced in a distribution list; however, a queue alias can be included in the distribution list that references a private queue.)
| For information on | See |
|---|---|
| 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 distribution list format names | Distribution List 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 for computer journals, dead-letter queues, and connector queues | Machine and Connector Format Names |