Private Format Names

  • Article

 

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