MSMQQueueInfo.ServiceTypeGuid (Windows Embedded CE 6.0)
1/6/2010
This property specifies the type of service provided by the queue.
Syntax
HRESULT get_ServiceTypeGuid(
BSTR* pbstrGuidServiceType
);
HRESULT put_ServiceTypeGuid(
BSTR bstrGuidServiceType
);
Parameters
- pbstrGuidServiceType or bstrGuidServiceType
GUID, predefined or application generated.
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
MSMQQueueInfo.ServiceTypeGuid is used to identify the queue by its type of service.
This property is typically set when the queue is created. However, the service type identifier of an existing queue can be changed as well.
Using the Service Type to Locate Queues
The service type identifier of a queue can be used to locate public queues registered in the directory service.
Setting and Retrieving the Service Type Identifier
To specify the service type identifier when creating a queue, set MSMQQueueInfo.ServiceTypeGuid and call the MSMQQueueInfo.Create method.
Note
To generate a GUID, run the Uuidgen.exe program provided by MSDN.
To reset the service type of an open queue, set MSMQQueueInfo.ServiceTypeGuid to a new GUID and call the MSMQQueueInfo.Update method. This method updates the queue information stored by Message Queuing.
To retrieve the service type identifier of a queue, call the MSMQQueueInfo.Refresh method.
Requirements
Header | mqoai.h |
Library | mqoa.lib |
Windows Embedded CE | Windows CE .NET 4.0 and later |