Syntax

qa_long QAMessage::getTimestamp()

Remarks

Gets the message timestamp.

This Timestamp header field contains the time a message was created. It is a coordinated universal time (UTC).

It is not the time the message was actually transmitted, because the actual send may occur later due to transactions or other client-side queuing of messages. It is in units that are natural for the platform. For Windows/PocketPC platforms, the timestamp is a SYSTEMTIME, converted to a FILETIME, which is copied to a qa_long value.

To convert a timestamp ts to SYSTEMTIME for displaying to a user, run the following code:

SYSTEMTIME      stime;
FILETIME        ftime;
ULARGE_INTEGER  time;
time.QuadPart = ts;
memcpy(&ftime, &time, sizeof(FILETIME));
FileTimeToSystemTime(&ftime, &stime);

For more information about getting and setting message headers and properties, see Introduction to QAnywhere messages.

Returns

The message timestamp.