Application-Specific Filter (COM) (Windows CE 5.0)

Send Feedback

This filter retrieves all message with a specific value of application-specific information.

This filter removes messages from the queue.

When a message with the desired application-specific information is found, MSMQQueue.ReceiveCurrent is called to remove the message, and MSMQQueue.PeekCurrent is called to look at the next message.

When a message is removed from the queue, the cursor is moved to the next message in the queue.

Note   If you do not want to remove messages from the queue, use MSMQQueue.PeekCurrent to look at the current message, and use MSMQQueue.PeekNext to move the cursor and look at the next message.

To create an application-specific filter

  1. Declare the MSMQQueueInfo, MSMQQueue, and MSMQMessage objects needed to create the filter.

  2. Call MSMQQueueInfo.Open to open the queue with receive access.

    Receive access allows you to peek at and retrieve messages.

  3. Call MSMQQueue.PeekCurrent to peek at the first message in the queue.

    Before using the cursor to navigate through the queue, you must point the cursor to the first message in the queue.

  4. Filter out the messages in the queue.

    MSMQQueue.ReceiveCurrent and MSMQQueue.PeekCurrent are used if the message is removed.

    MSMQQueue.PeekNext is used if the message is does not fit the search criteria.

  5. Call MSMQQueue.Close to close the queue.

See Also

MSMQ Application Development | MSMQ COM Support | Using the COM Components | MSMQ Security

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.