MSMQQueueInfo.ServiceTypeGuid (Compact 2013)

3/26/2014

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

See Also

Reference

MSMQQueueInfo