PROPID_M_ARRIVEDTIME

  • Article

This property indicates when the message arrived at the queue.

Parameters

  • Type Indicator
    VT_UI4 (or VT_NULL)
  • PROPVARIANT Field
    ulVal
  • Property Values
    Unsigned integer.

Remarks

The PROPID_M_ARRIVEDTIME property is attached to the message by MSMQ. The arrival time returned is the number of seconds elapsed since midnight (00:00:00), January 1, 1970 (Coordinated Universal time) according to the system clock.

To retrieve the arrived time of a message, specify PROPID_M_ARRIVEDTIME in the MQMSGPROPS structure. Then call MQReceiveMessage and examine the returned value. When specifying PROPID_M_ARRIVEDTIME, you can set its Type Indicator to VT_NULL. When the Type Indicator is set to VT_NULL, MSMQ sets the VT field to the appropriate type indicator.

Microsoft provides several time functions that can be used to manipulate the returned Coordinated Universal time value. These functions are defined in the time.h header file.

When reading messages from a journal queue, PROPID_M_ARRIVETIME indicates the time the original message arrived at its destination queue, not when the copy of the original message arrived in the queue journal.

When reading messages from machine journal or dead-letter queues, PROPID_M_ARRIVETIME indicates when the message reached the journal or dead-letter queue.

Example

This example shows how PROPID_M_ARRIVEDTIME is specified in the MQMSGPROPS structure.

aMsgPropId[i] = PROPID_M_ARRIVEDTIME;        // Property ID
aMsgPropVar[i].vt = VT_UI4;                  // Type indicator
aMsgPropVar[i].ulVal = dwArrivedTime;        // Value
i++;

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later. Versions prior to 2.12 require the MSMQ add-on pack. Mq.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

MQReceiveMessage, PROPID_M_SENTTIME, MQMSGPROPS

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.