PROPID_Q_MODIFY_TIME

Optional. This property indicates the last time the properties of a queue were modified.

  • Type Indicator
    VT_I4
  • PROPVARIANT Field
    lVal
  • Property Values
    Time at which the properties of the queue were last set.

Remarks

The PROPID_Q_MODIFY_TIME property is set by MSMQ when MQCreateQueue is called and then reset by MSMQ each time the properties of the queue 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.

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 and examine its returned value.

An MQ_ERROR_PROPERTY_NOTALLOWED error is returned if any attempt is made to set this property.

Example

This example shows how PROPID_Q_MODIFY_TIME is specified in the MQQUEUEPROPS structure for retrieving the date and time at which the properties of the queue were last modified.

aPropID[i] = PROPID_Q_MODIFY_TIME;    // Property identifier
aVariant[i].vt = VT_I4;               // Type indicator
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

MQCreateQueue, MQGetQueueProperties, MQSetQueueProperties, MQQUEUEPROPS

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.