MSMQEvent.ArrivedError (Windows Embedded CE 6.0)

1/6/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.

• ErrorCode
  Error code returned by MQReceiveMessage.

• 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

See Also

Reference

MSMQEvent