MSMQQueue

MSMQQueue

 

The MSMQQueue object represents an open instance of a queue that is represented by an MSMQQueueInfo object. The MSMQQueue object provides the methods needed to read and delete the messages in the queue and the properties needed to manage the open queue.

For information on opening the queue, see the MSMQQueueInfo.Open method.

The MSMQQueue object defines the following methods.

Method

Description

MSMQQueue.Close 

Closes this instance of the queue.

MSMQQueue.EnableNotification 

Starts event notification for asynchronously reading messages in the queue.

MSMQQueue.Peek 

Returns the first message in the queue, or waits for a message to arrive if the queue is empty.

MSMQQueue.PeekByLookupId

(Introduced in MSMQ 3.0.) Returns the message referenced by the supplied lookup identifier.

MSMQQueue.PeekCurrent 

Returns the current message at the current cursor position and moves the cursor to the next message, or waits for a message to arrive.

MSMQQueue.PeekFirstByLookupId

(Introduced in MSMQ 3.0.) Returns the first message in the queue.

MSMQQueue.PeekLastByLookupId

(Introduced in MSMQ 3.0.) Returns the last message in the queue.

MSMQQueue.PeekNext 

Returns the next message in the queue but does not remove it from the queue.

MSMQQueue.PeekNextByLookupId

(Introduced in MSMQ 3.0.) Returns the message that follows the message referenced by the supplied message lookup identifier.

MSMQQueue.PeekPreviousByLookupId

(Introduced in MSMQ 3.0.) Returns the message that precedes the message referenced by the supplied message lookup identifier.

MSMQQueue.Purge

(Introduced in MSMQ 3.0) Deletes all the messages in the queue.

MSMQQueue.Receive 

Retrieves the first message in the queue, removing the message from the queue.

MSMQQueue.ReceiveByLookupId

(Introduced in MSMQ 3.0.) Retrieves the message referenced by the supplied lookup identifier and removes the message from the queue.

Used when navigating the queue using lookup identifiers.

MSMQQueue.ReceiveCurrent

Reads the message at the current cursor location.

MSMQQueue.ReceiveFirstByLookupId

(Introduced in MSMQ 3.0.) Returns the first message in the queue and removes the message from the queue.

MSMQQueue.ReceiveLastByLookupId

(Introduced in MSMQ 3.0.) Returns the last message in the queue and removes the message from the queue.

Used when navigating the queue using lookup identifiers.

MSMQQueue.ReceiveNextByLookupId

(Introduced in MSMQ 3.0.) Returns the message that follows the message referenced by the supplied message lookup identifier and removes the message from the queue.

Used when navigating the queue using lookup identifiers.

MSMQQueue.ReceivePreviousByLookupId

(Introduced in MSMQ 3.0.) Returns the message that precedes the message referenced by the supplied message lookup identifier and removes the message from the queue.

Used when navigating the queue using lookup identifiers.

MSMQQueue.Reset 

Returns the cursor to the start of the queue.

The MSMQQueue object defines the following properties.

Property

Description

MSMQQueue.Access 

Provides the access mode in which the queue was opened.

Run-time access: Read-only

Data type: Long

MSMQQueue.Handle 

Provides the handle of the opened queue.

Run-time access: Read-only

Data type: Long

MSMQQueue.IsOpen 

(Superseded by IsOpen2.) Provides an indicator of whether the queue is open.

Run-time access: Read-only

Data type: Short

MSMQQueue.IsOpen2 

(Introduced in MSMQ 3.0.) Provides an indicator of whether the queue is open.

Run-time access: Read-only

Data type: Boolean

MSMQQueue.QueueInfo 

Provides an MSMQQueueInfo object that contains the initial settings used to open the queue.

Run-time access: Read-only

Data type: MSMQQueueInfo

MSMQQueue.ShareMode 

Provides the share mode in which the queue was opened.

Run-time access: Read-only

Data type: Long

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.

Community Additions

ADD
Show:
© 2016 Microsoft