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.
A version of this page is also available for
4/8/2010

This property specifies the type of service provided by the queue.

Syntax

HRESULT get_ServiceTypeGuid( 
  BSTR* 
pbstrGuidServiceType 
);
HRESULT put_ServiceTypeGuid( 
  BSTR
 bstrGuidServiceType
);

Parameters

pbstrGuidServiceTypeor 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.ServiceTypeGuidis 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.ServiceTypeGuidand call the MSMQQueueInfo.Createmethod.

Note:
To generate a GUID, run the Uuidgen.exe program provided by MSDN.

To reset the service type of an open queue, set MSMQQueueInfo.ServiceTypeGuidto a new GUID and call the MSMQQueueInfo.Updatemethod. This method updates the queue information stored by Message Queuing.

To retrieve the service type identifier of a queue, call the MSMQQueueInfo.Refreshmethod.

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