Read-only. The QueueGuid property identifies the public queue associated with the MSMQQueueInfo object. The queue identifier is created by MSMQ when the queue is created.
Type: | GUID |
Run time: | read-only |
object.QueueGuid
Syntax Element | Description |
---|---|
object | Queue information (MSMQQueueInfo) object that defines the queue. |
GUID of public queue.
To find out the queue identifier of a queue, the application must first call Refresh. Although MSMQ creates the queue identifier when the queue is created, it does not update quidQueue until Refresh is called.
The QueueGuid property identifies the queue defined by the MSMQQueueInfo object. It does not identify an open instance of the queue.
This example creates a public queue and then uses Refresh to display the queue's identifier. To try this example using Microsoft Visual Basic (version 5.0), paste the code into the Code window of a form that has a single text box, run the example, and click the form.
Dim qinfo As MSMQQueueInfo
Private Sub Form_Click()
Set qinfo = New MSMQQueueInfo
qinfo.PathName = ".\guidQueueTest"
qinfo.Label = "Test Queue"
qinfo.Create
qinfo.Refresh 'Required to update QueueGuid
Text1.Text = "quidQueue = " + CStr(qinfo.QueueGuid)
End Sub
Windows NT: Requires version 4.0 SP3 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in mqoai.h.
Import Library: Use mqoa.lib.
Unicode: Defined only as Unicode.
Create, Label, MSMQQueueInfo, PathName, Refresh