BeginReceive(TimeSpan,Cursor,Object,AsyncCallback) Method

Initiates an asynchronous receive operation that has a specified time-out and uses a specified cursor and a specified state object. The state object provides associated information throughout the lifetime of the operation. This overload receives notification, through a callback, of the identity of the event handler for the operation. The operation is not complete until either a message becomes available in the queue or the time-out occurs.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Overloads Function BeginReceive( _
   ByVal timeout As TimeSpan, _
   ByVal cursor As Cursor, _
   ByVal state As Object, _
   ByVal callback As AsyncCallback _
) As IAsyncResult

'Usage
 
Dim instance As MessageQueue
Dim timeout As TimeSpan
Dim cursor As Cursor
Dim state As Object
Dim callback As AsyncCallback
Dim value As IAsyncResult
 
value = instance.BeginReceive(timeout, cursor, state, callback)

public IAsyncResult BeginReceive( 
   TimeSpan timeout,
   Cursor cursor,
   object state,
   AsyncCallback callback
)

public:
IAsyncResult^ BeginReceive( 
   TimeSpan timeout,
   Cursor^ cursor,
   Object^ state,
   AsyncCallback^ callback
)

Parameters

timeout: A System.TimeSpan that indicates the interval of time to wait for a message to become available.
cursor: A Cursor that maintains a specific position in the message queue.
state: A state object, specified by the application, that contains information associated with the asynchronous operation.
callback: The System.AsyncCallback that receives the notification of the asynchronous operation completion.

Return Value

The System.IAsyncResult that identifies the posted asynchronous request.

Exceptions

Exception	Description
System.ArgumentNullException	The cursor parameter is null.
System.ArgumentException	The value specified for the timeout parameter is not valid.
MessageQueueException	An error occurred when accessing a Message Queuing method.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

MessageQueue Class
MessageQueue Members
Overload List