PROPID_M_SENTTIME
This property indicates the date and time that the message was sent by the source Queue Manager.
- Type Indicator
VT_UI4 (or VT_NULL) - PROPVARIANT Field
ulVal
Remarks
The PROPID_M_SENTTIME property is attached to the message by MSMQ. The 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 see when a message was sent, specify PROPID_M_SENTTIME in the MQMSGPROPS structure. Then call MQReceiveMessage and examine the returned value. When specifying PROPID_M_SENTTIME, 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.
Example
This example shows how PROPID_M_SENTTIME is specified in the MQMSGPROPS structure.
aMsgPropId[i] = PROPID_M_SENTTIME; // Property ID
aMsgPropVar[i].vt = VT_UI4; // Type indicator
aMsgPropVar[i].ulVal = dwSentTime; // 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_ARRIVEDTIME, MQMSGPROPS
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.