Share via

MSMQEvent.ArrivedError (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

MSMQEvent