 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This read-only property identifies the public queue associated with the MSMQQueueInfoobject. The queue identifier is created by Message Queuing when the queue is created.
Syntax
HRESULT get_QueueGuid( BSTR* pbstrGuidQueue ); |
Parameters
- pbstrGuidQueue
-
GUID of public queue.
Return Value
The following table describes the common return values.
| Value | Description |
|---|---|
|
S_OK |
Success |
|
E_INVALIDARG |
One or more arguments are invalid |
|
E_NOTIMPL |
The function contains no implementation |
|
E_OUTOFMEMORY |
Out of memory |
Remarks
Message Queuing sets MSMQQueueInfo.QueueGuidwhen the queue is created.
This property identifies the queue defined by the MSMQQueueInfoobject. It does not identify an open instance of the queue.
Locating Queues Based on
Identifiers
The MSMQQueueInfo.QueueGuidproperty can be used as search criteria when making a query of existing public queues.
Retrieving the Create Time
To retrieve the stored create time of a queue, call the MSMQQueueInfo.Refreshmethod and inspect the MSMQQueueInfo.QueueGuidproperty.
Message Queuing stores the identifier in the directory service (for public queues) and on the local computer (for private queues). The local value of MSMQQueueInfoobject is not updated until the MSMQQueueInfo.Refreshmethod is called.
Equivalent Function
Property
When using function calls, you can retrieve the QUID identifier of an existing queue by retrieving PROPID_Q_INSTANCE.
Requirements
| Header | mqoai.h |
| Library | mqoa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |