Platform SDK: CDO 1.2.1

TimeExpired Property (Message Object)

The TimeExpired property specifies the date/time the message becomes invalid and can be safely deleted. Read/write.

Syntax

objMessage.TimeExpired

Data Type

Variant (vbDate format)

Remarks

The TimeExpired property is not required on an AppointmentItem, MeetingItem, or Message object. If the sender does not set TimeExpired, an attempt by the receiver to read it returns CdoE_NOT_FOUND.

AppointmentItem objects in a Microsoft® Schedule+ calendar folder do not have the full set of attributes of a general message. If you obtain the default calendar folder by passing CdoDefaultFolderCalendar to the Session object's GetDefaultFolder method, its appointments have no defined value for the TimeExpired property. An attempt to access TimeExpired in this case returns CdoE_NOT_FOUND.

The TimeExpired property corresponds to the MAPI property PR_EXPIRY_TIME.

Example

This code fragment sets the expiry time of a message to September 2, 1998 at 9:00 in the morning:

' ... verify that objOneMsg is valid, then ... 
objOneMsg.TimeExpired = Cdate(#2Sep1998 09:00#)