Share via


MSMQEvent.ArrivedError

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This event is fired when MSMQQueue.EnableNotification is called and an error is generated.

Syntax

void ArrivedError(
  Idispatch* Queue, 
  long ErrorCode, 
  long Cursor 
);

Parameters

  • eventObject
    Instance of MSMQEvent event used for the event handler.
  • Queue
    MSMQQueue object that represents an open instance of the queue where the message arrived.
  • Cursor
    Value of the Cursor argument in the call to MSMQQueue.EnableNotification that triggered the event.

    Its values can be

    • MQMSG_FIRST (default value of EnableNotification)
    • MQMSG_CURRENT
    • MQMSG_NEXT

Remarks

An ArrivedError event can be triggered in these ways:

  • By the message's time-out timer expiring
  • By an error occurring while the queue is receiving the message

The message's time-out timer can be used when the application will wait 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 errors generated while the application is trying to read messages in the queue.

Requirements

Header mqoai.h
Library mqoa.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later