Optional. The PROPID_Q_MODIFY_TIME property indicates the last time the properties of a queue were modified.
The PROPID_Q_MODIFY_TIME property is set by MSMQ when MQCreateQueue is called and then reset by MSMQ each time the queue's properties are modified by calls to MQSetQueueProperties.
The time returned by MSMQ is the number of seconds elapsed since midnight (00:00:00), January 1, 1970 (Coordinated Universal time) according to the system clock.
There are several related C run-time functions that can be used to manipulate the value of PROPID_Q_MODIFY_TIME. For example, ctime() can be used to display the local date and time when the queue's properties were last modified.
Note Details on the C run-time functions can be found in the Platform SDK. When using these functions, include the time.h header file in your source code.
To retrieve the date and time at which the queue properties were last modified, specify PROPID_Q_MODIFY_TIME in the MQQUEUEPROPS structure, and then call MQGetQueueProperties (or MQLocateBegin when starting a query) and examine its returned value.
An MQ_ERROR_PROPERTY_NOTALLOWED error is returned if any attempt is made to set this property.
This example shows how PROPID_Q_MODIFY_TIME is specified in the MQQUEUEPROPS structure for retrieving the date and time at which the queue's properties were last modified.
//To retrieve the date and time
aPropID[i] = PROPID_Q_MODIFY_TIME; // Property identifier
aVariant[i].vt = VT_I4; // Type indicator
i++
| For complete examples of… | See… |
|---|---|
| Retrieving the time when the queue's properties were last modified | Retrieving PROPID_Q_MODIFY_TIME |
Windows NT: Requires version 4.0 SP3 or later.
Windows: Requires Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in mq.h.
Import Library: Use mqrt.lib.
Unicode: Defined only as Unicode.
MQCreateQueue, MQGetQueueProperties, MQLocateBegin, MQSetQueueProperties