Public 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

Public format names are used to reference public queues. They are used to perform the following operations:

  • To open a public queue to send messages and request routing. A public queue can be opened with a public or direct format name. When a public 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 public queue to read messages.

  • To retrieve and set the properties of a public queue.

  • To retrieve or set the security descriptor of a public queue.

When the queue manager detects a public format name, it looks in the directory service to determine what computer is currently hosting the queue, what protocol the host computer uses, and any other information that it needs to route the message to the queue. Public format names cannot be used on computers operating in workgroup mode.

Public format names contain the string "PUBLIC=" followed by the identifier (GUID) of the queue that is generated by Message Queuing when the queue is created. The following is the general form of the public format names used to reference a public queue and its associated queue journal:

PUBLIC=QueueGUID                  *Public queues.  
PUBLIC=QueueGUID;JOURNAL          *Public queue journals.  

A public format name is strictly equivalent to the identifier of the queue (see PROPID_Q_INSTANCE or MSMQQueueInfo.QueueGuid) except that a public format name is formatted as a string rather than as binary data. The following line of code is an example of a public format name string (note that the format name string is a null-terminated Unicode string).

LPWSTR wsz = L"PUBLIC=308FB580-1EB2-11CA-923B-08002B1075A7";  

Public format names can also be used to reference a public queue in distribution lists and multiple-element format names. Distribution lists and multiple-element format names can be used to send messages to multiple destinations and specify multiple response queues.

The location of a public queue (the specific computer where the messages belonging to the queue are stored) is not part of the public format name. This allows message operations to succeed when using public format names regardless of whether the location of the queue is known to the caller.

For information onSee
Ways to obtain a format nameObtaining Format Names
The elements and syntax of private format namesPrivate Format Names
The elements and syntax of distribution list format namesDistribution List 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 names for computer journals, dead-letter queues, and connector queuesMachine and Connector Format Names

Community Additions

ADD
Show: