Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This read-only property indicates when the queue properties of a public and private queue were last updated.

Syntax 

HRESULT get_ModifyTime( 
  VARIANT* 
pvarModifyTime 
);

Parameters

pvarModifyTime

Date and time when the queue properties were last updated. It includes when the queue was created and the last time MSMQQueueInfo.Updatewas called.

Return Value

The following table describes the common return values.

Value Description

S_OK

Success

E_INVALIDARG

One or more arguments are invalid

E_NOTIMPL

The function contains no implementation

E_OUTOFMEMORY

Out of memory

Remarks

Message Queuing sets this property, storing the value of the property when the queue is created and when MSMQQueueInfo.Updateis called.

Locating Queues Based on Modify Time

The MSMQQueueInfo.ModifyTimeproperty can be used as search criteria when making a query of existing public queues.

Retrieving the Modify Time

To retrieve the stored modify time of a queue, call the MSMQQueueInfo.Refreshmethod and inspect the MSMQQueueInfo.ModifyTimeproperty.

Message Queuing stores the modify time in the directory service for public queues and on the local computer for private queues. The local value of MSMQQueueInfoobject is not updated until the application calls MSMQQueueInfo.Refreshmethod.

Equivalent Function property

When using function calls, the date and time the queue properties were last modified can be retrieved using the PROPID_Q_MODIFY_TIME property.

Requirements

Header mqoai.h
Library mqoa.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later