PeekById(String,TimeSpan) Method

Peeks the message whose message identifier matches the parameter. Waits until the message appears in the queue or a time-out occurs.

Syntax

Visual Basic
C#
C++/CLI

'Declaration
 
Public Overloads Function PeekById( _
   ByVal id As String, _
   ByVal timeout As TimeSpan _
) As Message

'Usage
 
Dim instance As MessageQueue
Dim id As String
Dim timeout As TimeSpan
Dim value As Message
 
value = instance.PeekById(id, timeout)

public Message PeekById( 
   string id,
   TimeSpan timeout
)

public:
Message^ PeekById( 
   String^ id,
   TimeSpan timeout
)

Parameters

id: The Id of the message to peek.
timeout: A System.TimeSpan that indicates the time to wait until a new message is available for inspection.

Return Value

The Message whose Id property matches the parameter.

Exceptions

Exception	Description
System.ArgumentNullException	The id parameter is null.
System.ArgumentException	The value specified for the timeout parameter is not valid, possibly timeout is less than System.TimeSpan.Zero or greater than InfiniteTimeout.
System.InvalidOperationException	The message with the specified id does not exist in the queue and did not arrive before the period specified by the timeout parameter expired.
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