IRecurrencePattern::put_StartTime (Windows Embedded CE 6.0)

1/6/2010

The StartTime property gets or sets the start time of the recurrence pattern.

To set the value of the StartTime property, call the property method described here.

To get the value of the StartTime property, see the IRecurrencePattern::get_StartTime property method.

Syntax

HRESULT put_StartTime(
   DATE st
);

Parameters

• st
  [in] The recurrence pattern start time expressed as a Variant time date object. For information on the DATE type, see IPOutlookApp::VariantTimeToSystemTime. For information on the SYSTEMTIME structure, see SYSTEMTIME.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:

• S_OK
  The method completed successfully.

Remarks

Recurrence duration applies to Appointment items only. It is the difference between PIMPR_RECURRING_ENDTIME and PIMPR_RECURRING_STARTTIME.

The time returned is in the time zone of the Appointment.

The Duration value is ignored if you set both StartTime and EndTime. If you set only one, Outlook Mobile uses the Duration value to calculate the other.

If you do not set the duration, Outlook Mobile sets it from information contained in the Appointment item.

The Duration value cannot be longer than 31 days.

When you change a Recurrence Pattern's Duration property, the Duration property of each Appointment item that is associated with this Recurrence Pattern also changes. For example, you might use IRecurrencePattern::put_Duration if you wanted to change the duration of a weekly meeting from 60 minutes, to 30 minutes.

Requirements

Header	pimstore.h
Library	Pimstore.lib
Windows Embedded CE	Windows CE 2.0 and later

See Also

Tasks

Creating a Recurring Appointment

Reference

IRecurrencePattern
IRecurrencePattern::get_StartTime
Pocket Outlook Object Model Interfaces