PROPID_Q_CREATE_TIME

Optional read-only. The PROPID_Q_CREATE_TIME property indicates the time and date when the queue was created.

Type Indicator

VT_I4

PROPVARIANT Field

lVal

Property Values

Time when the queue was created.

Remarks

This property is set by MSMQ when MQCreateQueue is called. An error is returned (MQ_ERROR_PROPERTY_NOTALLOWED) if any attempt is made to set this property. 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.

There are several related C run-time functions that can be used to manipulate the value of PROPID_Q_CREATE_TIME. For example, ctime() can be used to display the local date and time the queue was created.

Note  Details on the C run-time functions can be found in the Platform SDK. When using these functions, include time.h in your source code.

To retrieve the date and time a queue was created, specify PROPID_Q_CREATE_TIME in the MQQUEUEPROPS structure and call MQGetQueueProperties and examine its returned value.

Example

This example shows how PROPID_Q_CREATE_TIME is specified in the MQQUEUEPROPS structure for retrieving the date and time when the queue was created.

//To retrieve the date and time
aPropID[i] = PROPID_Q_CREATE_TIME;    // Property identifier
aVariant[i].vt = VT_I4;               // Type indicator
i++
 

QuickInfo

  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.

See Also

MQCreateQueue, MQGetQueueProperties