Retrieving Messages to Read
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
Retrieving a message in a queue removes it from the queue. You can retrieve a specific message from a queue, or purge a queue by retrieving all the messages in a queue.
Message Queuing provides a way to always retrieve the first message in a queue, or retrieve a message at a specific cursor location. This second functionality is used when you use a cursor to navigate through a queue. In addition, messages can be retrieved from their destination queues either synchronously or asynchronously, thus allowing the receiving application to halt processing or continue processing while it is retrieving the messages from their queues.
| For information on | See |
|---|---|
| Synchronous operations | Synchronous Reading |
| Asynchronous operations | Asynchronous Reading |
| Leaving a message when it is read | Peeking at Messages |
| Reading past the first message in the queue | Navigating with Cursors |
| How transactions work and the different types of transactions | Transactions |
| Reading the first message in the queue synchronously | C/C++ Code Example: Reading Messages Synchronously C/C++ COM Code Example: Reading Messages Synchronously Visual Basic Code Example: Reading Messages Synchronously |
| Reading messages asynchronously | C/C++ Code Example: Reading Messages Asynchronously Using a Callback Function C/C++ Code Example: Reading Messages Asynchronously Using Completion Ports C/C++ COM Code Example: Reading Messages Asynchronously Visual Basic Code Example: Reading Messages Asynchronously |