MSMQQueueInfo.QueueGuid (Windows Embedded CE 6.0)
1/6/2010
This read-only property identifies the public queue associated with the MSMQQueueInfo object. 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.QueueGuid when the queue is created.
This property identifies the queue defined by the MSMQQueueInfo object. It does not identify an open instance of the queue.
.gif "Ee499828.collapse(en-US,WinEmbedded.60).gif")
Locating Queues Based on Identifiers
The MSMQQueueInfo.QueueGuid property 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.Refresh method and inspect the MSMQQueueInfo.QueueGuid property.
Message Queuing stores the identifier in the directory service (for public queues) and on the local computer (for private queues). The local value of MSMQQueueInfo object is not updated until the MSMQQueueInfo.Refresh method 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 |