MSMQEvent.ArrivedError
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
The ArrivedError event of the MSMQEvent object is fired when the MSMQQueue.EnableNotification method of an instance of the MSMQQueue object representing an open queue has been called and an error is generated for a message arriving at the applicable position in the specified queue.
Event ArrivedError( _
ByVal Queue As Object, _
ByVal ErrorCode As Long, _
ByVal Cursor As Long _
)
Parameters
Queue
Queue (MSMQQueue) object passed by value that represents an open instance of the queue where the message arrived.
ErrorCode
Long passed by value that contains the error code returned by MQReceiveMessage. This argument is passed by value.
Cursor
Long containing the value of the Cursor argument in the call to MSMQQueue.EnableNotification that initiated event notification. This argument is passed by value. Its values may be MQMSG_FIRST (the default value for EnableNotification), MQMSG_CURRENT, or MQMSG_NEXT.
Remarks
An ArrivedError event can be triggered by the receive time-out timer expiring or by an error occurring while the queue is receiving the message. The receive time-out timer can be used when the application waits a specific amount of time to receive its messages.
This event applies only to messages failing to arrive at the queue; it is not associated with any errors generated while the application is trying to read messages in the queue.
Example Code
The following examples are included in Using Message Queuing.
| For an example of | See |
|---|---|
| Writing an ArrivedError event handler | C/C++ COM Code Example: Reading Messages Asynchronously Visual Basic Code Example: Reading Messages Asynchronously |
Requirements
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