Queue Handle
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
A queue handle references an open queue or, when using distribution lists, multicast addresses, or multiple-element format names to send messages, a set of open queues. While the queue is open, applications can use the handle of the queue to perform the following operations:
To send messages using the MQSendMessage function.
To read messages using the MQReceiveMessage or MQReceiveMessageByLookupId (introduced in MSMQ 3.0) functions
To generate a format name for the queue using the MQHandleToFormatName function.
To create a cursor using the MQCreateCursor function.
To close the queue using the MQCloseQueue function.
Using the Queue Handle Within COM Components
The queue handle is used internally by Message Queuing COM components even though it is not explicitly used by applications. However, the MSMQQueue object exposes the queue handle in the MSMQQueue.Handle property so that applications can call Message Queuing API functions directly. For example, when using Microsoft® Visual Basic®, you can call Message Queuing functions directly using the Declare Function facility.
| For information on | See |
|---|---|
| Referencing a queue by its path name | Queue Path Names |
| Referencing a queue by its format name | Format Names |