Share via


Setting Queue Properties (COM) (Windows Embedded CE 6.0)

1/6/2010

The properties of a queue can be dynamically set by calling MSMQQueueInfo.Update.

Note

MSMQQueueInfo.Update can only be called on queues that exist. It cannot be called on an MSMQQueueInfo object before the queue is created or after the queue is deleted.

When updating public queues, the directory service is updated with the current settings of the MSMQQueueInfo object. Always call MSMQQueueInfo.Refresh first to retrieve the existing settings of the queue. This will retrieve any changes that have been made using Active Directory or another application.

When updating private queues, the local computer is updated with the current settings of the MSMQQueueInfo object. Properties for private queues can only be updated if the queue is located on the local computer.

In most cases, any application can set a queue's properties. However, if MQ_ERROR_ACCESS_DENIED is returned by MSMQQueueInfo.Update, the access control level of the queue is blocking the application from setting the queue's properties.

Note

Not all properties can be set by calling MSMQQueueInfo.Update. Only the properties in the following examples can be set in this way. Other properties can only be set by Message Queuing, or they can only be set when the queue is created.

For examples on See

Setting the authentication level of the queue

Setting MSMQQueueInfo.Authenticate

Setting the base priority level of the queue

Setting MSMQQueueInfo.BasePriority

Setting the journaling level of the queue

Setting MSMQQueueInfo.Journal

Setting the maximum size of the queue journal

Setting MSMQQueueInfo.JournalQuota

Setting the label of the queue

Setting MSMQQueueInfo.Label

Setting the privacy level of the queue

Setting MSMQQueueInfo.PrivLevel

Setting the maximum size of the queue

Setting MSMQQueueInfo.Quota

Setting the type of service performed by the queue

Setting MSMQQueueInfo.ServiceTypeGuid

See Also

Concepts

Using the COM Components
MSMQ COM Support
MSMQ Security

Other Resources

Message Queuing