Export (0) Print
Expand All

MSMQQueueInfos

The MSMQQueueInfos object represents a query and provides methods for querying the directory service to locate existing public queues that satisfy the search criteria specified in the query. The MSMQQueueInfos object is created and initialized by the MSMQQuery.LookupQueue method. The MSMQQueueInfos.Next method moves the cursor to the first queue in the collection of public queues that satisfy the search criteria of the query and returns an MSMQQueueInfo object that represents the first queue. Next can be called repeatedly to enumerate all the elements of the collection.

The collection of public queues that satisfies the search criteria specified in a query is dynamic, with other clients altering the properties of the queues or deleting them from the collection at any time. As a consequence, there is no queue count available for enumerating the elements of the collection. In place of a queue count, MSMQQueueInfos provides an end-of-list (EOL) mechanism to indicate when you have completely enumerated the elements of the collection.

The following example shows how the EOL mechanism is used in a standard Microsoft® Visual Basic® type While loop.

' Display the format names of all queues
' with the label "examplequeue".
Dim queryMyQuery As New MSMQQuery
Dim qinfoCurrent As MSMQQueueInfo
' Get some interesting queues.
Dim qinfos As MSMQQueueInfos
Set qinfos = queryMyQuery.LookupQueue( _
    Label:="examplequeue")
Set qinfoCurrent = qinfos.Next
While Not qinfoCurrent Is Nothing
    MsgBox qinfoCurrent.FormatName
    Set qinfoCurrent = qinfos.Next
Wend

Methods

The MSMQQueueInfos object defines the following methods.

Method Description

MSMQQueueInfos.Next

Returns an MSMQQueueInfo object that represents the next queue in the collection of public queues satisfying the search criteria of the query.

MSMQQueueInfos.Reset

Moves the cursor to the position before the first queue in the collection of public queues satisfying the search criteria of the query.

Requirements

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.

See Also

Show:
© 2014 Microsoft