PROPID_Q_BASEPRIORITY

Optional. The PROPID_Q_BASEPRIORITY property specifies a single base priority for all messages sent to a public queue.

Type Indicator
VT_I2
PROPVARIANT Field
iVal
Property Values
Integer value between -32768 and +32767 (the default is 0).

Remarks

A public queue's base priority is used for routing the queue's messages over the network. It can be used to give the messages sent to the queue a higher (or lower) priority than messages sent to other queues. For example, when a queue's base priority is set, all the messages sent to it are given a higher priority than messages sent to queues with a lower base priority. The queue's base priority has no effect on the order of the messages in the queue, or how messages are read from the queue.

PROPID_Q_BASEPRIORITY only applies to public queues that can be located through MQIS (using a public format name). The base priority of private queues, as well as public queues accessed directly, is always 0.

MSMQ combines the queue's base priority with the message's priority (PROPID_M_PRIORITY) to determine the overall priority of a message when it is sent to the queue.

To set the base priority of a public queue, pass PROPID_Q_BASEPRIORITY to MQCreateQueue.

To change the base priority of a public queue, pass PROPID_Q_BASEPRIORITY to MQSetQueueProperties.

To determine the base priority of a queue, pass PROPID_Q_BASEPRIORITY to MQGetQueueProperties and examine its returned value.

See Also

MQCreateQueue, MQGetQueueProperties, MQSetQueueProperties, PROPID_M_PRIORITY


© 1997 by Microsoft Corporation. All rights reserved.