Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

The MSMQQueueInfoobject provides queue management for a single queue. It provides methods for the following:

Creating a queue (transactional or nontransactional)
Opening a queue
Changing the properties of a queue
Deleting a queue

MSMQQueueInfoobjects are returned by a query or are created by the sending or receiving application.

There is a one-to-one relationship between each MSMQQueueInfoobject and the queue it represents.

There is a one-to-many relationship between the MSMQQueueInfoobject of the queue and the MSMQQueueobjects that represent open instances of the queue.

Methods

The following table lists the methods of the MSMQQueueInfoobject.

Method	Description
MSMQQueueInfo.Create	Creates a queue based on the queue properties of the MSMQQueueInfoobject.
MSMQQueueInfo.Delete	Deletes an existing queue.
MSMQQueueInfo.Open	Opens a queue, returning an MSMQQueueobject.
MSMQQueueInfo.Refresh	Refreshes the property values of the MSMQQueueInfoobject with the values stored in the directory service (for public queues) or the local computer (for private queues).
MSMQQueueInfo.Update	Updates the directory service or the local computer with the current property values of the MSMQQueueInfoobject.

Properties

The following table lists the properties of the MSMQQueueInfoobject.

Property	Description
MSMQQueueInfo.Authenticate Access: Read/write Data type: Long	Specifies whether the queue accepts only authenticated messages.
MSMQQueueInfo.BasePriority Access: Read/write Data type: Long	Specifies a base priority for all messages sent to a public queue.
MSMQQueueInfo.CreateTime Access: Read-only Data type: Date Variant	(Read-only, introduced in MSMQ 2.0 for private queues.) Provides the time and date when the public or private queue was created.
MSMQQueueInfo.FormatName Access: Read/write Data type: String	Specifies the format name of the queue.
MSMQQueueInfo.IsTransactional Access: Read-only Data type: Short	Indicates whether the queue supports transactions.
MSMQQueueInfo.IsWorldReadable Access: Read-only Data type: Short	Indicates whether everyone can read the messages in the queue.
MSMQQueueInfo.Journal Access: Read/write Data type: Long	Specifies whether or not messages retrieved from the queue are stored in a queue journal.
MSMQQueueInfo.JournalQuota Access: Read/write Data type: Long	Specifies the maximum size of the queue journal.
MSMQQueueInfo.Label Access: Read/write Data type: String	Specifies a description of the queue or message.
MSMQQueueInfo.ModifyTime Access: Read-only Data type: Date Variant	(Read-only, introduce in MSMQ 2.0 for private queues.) Provides the time and date when the stored properties of the queue were last updated.
MSMQQueueInfo.PathName Access: Read/write Data type: String	Specifies the Message Queuing pathname of the queue.
MSMQQueueInfo.PrivLevel Access: Read/write Data type: Long	Specifies the privacy level of a queue or message.
MSMQQueueInfo.QueueGuid Access: Read-only Data type: GUID	(Read-only.) Provides the identifier of the public queue associated with the MSMQQueueInfo object.
MSMQQueueInfo.Quota Access: Read/write Data type: Long	Specifies the maximum size of the queue.
MSMQQueueInfo.ServiceTypeGuid Access: Read/write Data type: GUID	Specifies the type of service provided by the queue.

Requirements

Header	mqoai.h
Library	mqoa.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later