IAppointment::get_Start
A version of this page is also available for
4/8/2010
The Start property gets or sets when an appointment starts.
To get the value of the Start property, call the property method described here.
To set the value of the Start property, see the IAppointment::put_Start property method.
Syntax
HRESULT get_Start(
DATE * pst
);
Parameters
- pst
[out] Reference to date object that defines the start. 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
Dates must be between 1/1/1900 and 12/31/2999 inclusive.
The default start time is the top of the next hour. For example, if the current time is 10:37 A.M., the default start time is 11:00 A.M.
If you set the Appointment's IAppointment::get_End to a time before the Appointment's Start, Outlook Mobile ensures that the Appointment remains valid by automatically updating the Start time to maintain the original Duration.
get_Start returns the Start value that will be saved, not the last value set.
The Start and End times for recurring Appointments are set in terms of the Timezone property (Calendar Property ID's), but the Start and End times for individual Appointments are set and read in terms of the local (mobile device's) Timezone. For example, a recurring Appointment set to recur at noon London time, would occur at 4:00 AM Pacific time.
Requirements
Header | pimstore.h |
Library | Pimstore.lib |
Windows Embedded CE | Windows CE 2.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IAppointment
Pocket Outlook Object Model Interfaces