MSMQQueueInfo

 

Updated: July 19, 2016

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

The MSMQQueueInfo object provides queue management for a single queue. It provides methods for creating a queue (either a transactional or non-transactional queue), opening a queue, changing or retrieving the properties of a queue, and deleting a queue.

MSMQQueueInfo objects are either returned by a query using the MSMQQuery.LookupQueue method or created by the sending or receiving application. Before using an application-created MSMQQueueInfo object, the application must initialize it to reference a specific queue by setting its MSMQQueueInfo.FormatName or MSMQQueueInfo.PathName property.

There is a one-to-one relationship between each MSMQQueueInfo object and the queue it represents. However, as shown in the illustration below, there is a one-to-many relationship between the MSMQQueueInfo object of the queue and the MSMQQueue objects that represent open instances of the queue.

<No Change>

The MSMQQueueInfo object defines the following methods.

MethodDescription
MSMQQueueInfo.CreateCreates a queue based on the queue properties of the MSMQQueueInfo object.
MSMQQueueInfo.DeleteDeletes an existing queue.
MSMQQueueInfo.OpenOpens a queue, returning an MSMQQueue object.
MSMQQueueInfo.RefreshRefreshes the property values of the MSMQQueueInfo object with the values stored in the directory service (for public queues) or the local computer (for private queues).
MSMQQueueInfo.UpdateUpdates the directory service or the local computer with the current property values of the MSMQQueueInfo object.

The MSMQQueueInfo object defines the following properties.

PropertyDescription
MSMQQueueInfo.ADsPath(Introduced in MSMQ 3.0) Provides the ADs path to the queue object in the Active Directory Domain Services (AD DS) (not available for private queues).

Run-time access: Read-only

Data type: Long
MSMQQueueInfo.AuthenticateSpecifies whether the queue accepts only authenticated messages.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.BasePrioritySpecifies a base priority for all messages sent to a public queue.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.CreateTime(Read-only, introduced in MSMQ 2.0 for private queues.) Provides the time and date when the public or private queue was created.

Run time access: Read-only

Data type: Variant (Date)
MSMQQueueInfo.FormatNameSpecifies the format name of the queue.

Runtime access: Read/write

Data type: String
MSMQQueueInfo.IsTransactional(Superseded by IsTransactional2.) Indicates whether the queue supports transactions.

Runtime access: Read-only

Data type: Short
MSMQQueueInfo.IsTransactional2(Introduced in MSMQ 3.0, supersedes IsTransactional.) Indicates whether the queue supports transactions.

Runtime access: Read-only

Data type: Boolean
MSMQQueueInfo.IsWorldReadable(Superseded by IsWorldreadable2.) Indicates whether all members of the Everyone group can read messages in the queue.

Runtime access: Read-only

Data type: Short
MSMQQueueInfo.IsWorldReadable2(Introduced in MSMQ 3.0, supersedes IsWorldReadable.) Indicates whether all members of the Everyone group can read the messages in the queue.

Runtime access: Read-only

Data type: Boolean
MSMQQueueInfo.JournalSpecifies whether or not messages retrieved from the queue are stored in a queue journal.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.JournalQuotaSpecifies the maximum size of the queue journal.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.LabelSpecifies a description of the queue or message.

Runtime access: Read/write

Data type: String
MSMQQueueInfo.ModifyTime(Read-only, introduced in MSMQ 2.0 for private queues.) Provides the time and date when the stored properties of the queue were last updated.

Runtime access: Read-only

Data type: Variant (Date)
MSMQQueueInfo.MulticastAddress(Introduced in MSMQ 3.0.) Specifies the multicast address associated with the queue.

Runtime access: Read/write

Data type: String
MSMQQueueInfo.PathNameSpecifies the MSMQQueueInfo.PathName of the queue.

Runtime access: Read/write

Data type: String
MSMQQueueInfo.PathNameDNS(Read-only, introduced in MSMQ 2.0.) Provides the DNS path name of the queue.

Runtime access: Read-only

Data type: String
MSMQQueueInfo.PrivLevelSpecifies the privacy level of the queue.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.QueueGuidProvides the identifier of the public queue associated with the MSMQQueueInfo object.

Runtime access: Read-only

Data type: String (GUID format)
MSMQQueueInfo.QuotaSpecifies the maximum size of the queue.

Runtime access: Read/write

Data type: Long
MSMQQueueInfo.ServiceTypeGuidSpecifies the type of service provided by the queue.

Runtime access: Read/write

Data type: GUID

Windows NT/2000/XP: Included in Windows NT 4.0 SP3 and later.

Windows 95/98/Me: Included in Windows 95 and later.

Header: Declared in Mqoai.h.

Library: Use Mqoa.lib.

Message Queuing COM Components

Community Additions

ADD
Show: