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
The MSMQQueueInfos object defines the following methods.
Returns an MSMQQueueInfo object that represents the next queue in the collection of public queues satisfying the search criteria of the query.
Moves the cursor to the position before the first queue in the collection of public queues satisfying the search criteria of the query.
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.