Retrieving a Queue's Properties Using API Functions

After a queue is created, its properties can be retrieved at any time by calling MQGetQueueProperties. All queue properties can be retrieved; however, you can only retrieve the properties of private queues if they are located on your local computer.

Note Properties of public queues can also be retrieved by doing a query on the MQIS. For details, see Locating a Public Queue.

In most cases, any application can retrieve a queue's properties. However, if MQ_ERROR_ACCESS_DENIED is returned to the MQGetQueueProperties call, the queue's access control is blocking the application from retrieving its properties. For information setting a queue's access rights, see Setting Access Control Security for a Queue.

To retrieve a queue's properties

1. Obtain the format name of the queue. If the format name of the queue is not known, you can obtain its format name by using one of the following format name translation functions:

   MQHandleToFormatName

   MQInstanceToFormatName

   MQPathNameToFormatName.

2. Specify the properties you want to retrieve.
   
   
3. Call MQGetQueueProperties.

For more information about setting properties, see Setting a Queue's Properties Using API Functions.

Queue Properties

All properties of a queue can be retrieved. However, you can only retrieve the properties of a private queue if it is located on your local machine.

PROPID_Q_AUTHENTICATE

PROPID_Q_BASEPRIORITY (public queues only)

PROPID_Q_CREATE_TIME

PROPID_Q_INSTANCE (public queues only)

PROPID_Q_JOURNAL

PROPID_Q_JOURNAL_QUOTA

PROPID_Q_LABEL

PROPID_Q_MODIFY_TIME

PROPID_Q_PATHNAME

PROPID_Q_PRIV_LEVEL

PROPID_Q_QUOTA

PROPID_Q_TRANSACTION

PROPID_Q_TYPE

© 1997 by Microsoft Corporation. All rights reserved.