int get_message_time()

This function obtains the time stamp for the most recently retrieved message.



The time (in milliseconds) of the most recently retrieved message.


The time that is returned is for the message most recently obtained from the current thread's message queue by the function get_message. The time is an integer that specifies the elapsed time (in milliseconds) from the commencement of the system boot. Because the value wraps to zero if the timer count exceeds the maximum value for an integer, the value returned does not always increase between consecutive messages.