Setting Queue Properties (COM) (Windows CE 5.0)

Send Feedback

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

MSMQ Application Development | MSMQ COM Support | Using the COM Components | MSMQ Security

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.