Share via


Setting Queue Behavior

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

When you create a queue, you can define the behavior of a queue by setting its optional properties. For example, the following properties specify whether the queue can be used in a transaction, whether the queue will accept private message, and several other characteristics:

  • Authentication level—specifies whether the queue will accept all messages, or only those authenticated by Message Queuing.

    The related function property and COM property are:

    PROPID_Q_AUTHENTICATE

    MSMQQueueInfo.Authenticate

  • Priority level—specifies a base priority level for all messages sent to a public queue (the priority level of private queues is always set to 0).

    The related function property and COM property are:

    PROPID_Q_BASEPRIORITY

    MSMQQueueInfo.BasePriority

  • Privacy level—specifies whether the queue will accept only private messages, only messages that have not been encrypted, or both.

    The related function property and COM property are:

    PROPID_Q_PRIV_LEVEL

    MSMQQueueInfo.PrivLevel

  • Journaling level—specifies whether target journaling is enabled for the queue.

    The related function properties and COM properties are:

    PROPID_Q_JOURNAL

    MSMQQueueInfo.Journal

  • Queue quota—limits the amount of data that can be placed in the queue.

    The related function property and COM property are:

    PROPID_Q_QUOTA

    MSMQQueueInfo.Quota

  • Journal quota—limits the amount of data that can be placed in the queue journal.

    The related function properties and COM properties are:

    PROPID_Q_JOURNAL_QUOTA

    MSMQQueueInfo.JournalQuota

  • Service type—an application-defined or Message Queuing-defined identifier. Applications can use this property to locate a specific type of public queue in the directory service.

    The related function property and COM property are:

    PROPID_Q_TYPE

    MSMQQueueInfo.ServiceTypeGuid

  • Queue label—an application-defined identifier that can be used to identify the queue.

    The related function property and COM property are:

    PROPID_Q_LABEL

    MSMQQueueInfo.Label

  • Queue multicast address (introduced in MSMQ 3.0)—specifies an optional address that can be shared by several queues. Messages sent to a multicast address are sent, in turn, to all queues associated with that address.

    The related function property and COM property are:

    PROPID_Q_MULTICAST_ADDRESS

    MSMQQueueInfo.MulticastAddress

  • Transaction level—specifies whether the messages sent to the queue must be sent within a transaction. This property can be set only when the queue is created. When you are using COM components, you set the transaction level indirectly by setting the IsTransactional parameter of the MSMQQueueInfo.Create method.

    The related function property and COM method parameter are:

    PROPID_Q_TRANSACTION

    MSMQQueueInfo.Create (IsTransactional)

More Information

For information on See
Example code for creating queues Creating Queue Examples
Example code for setting and retrieving properties of existing queues. Changing Queue Behavior Examples