IPOutlookApp::SystemTimeToVariantTime
The SystemTimeToVariantTime method converts a system time object to it's Variant equivalent.
Syntax
HRESULT SystemTimeToVariantTime(
SYSTEMTIME * pst,
DATE * pdate
);
Parameters
- pst
[in] Reference to system time object to convert. - pdate
[out] Reference to the Variant time equivalent.
Return Values
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
A Variant time is stored as an 8-byte real value (double) representing a date between January 1, 100 and December 31, 9999, inclusive. The value 2.0 represents January 1, 1900; 3.0 represents January 2, 1900, and so on. Adding 1 to the value increments the date by a day. The fractional part of the value represents the time of day. Therefore, 2.5 represents noon on January 1, 1900; 3.25 represents 6:00 A.M. on January 2, 1900; and so on. Negative numbers represent the dates prior to December 30, 1899.
This method was needed for Windows Mobile–based devices running software prior to Pocket PC 2000. Its current implementation simply calls the Windows CE function SystemTimeToVariantTime, passing the same parameters. (DATE is type-defined as double in the file wtypes.h.)
Requirements
Pocket PC: Pocket PC 2000 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: pimstore.h
Library: pimstore.lib
See Also
How to: Create a PIM Item | IPOutlookApp | Pocket Outlook Object Model API Interfaces | Pocket Outlook Object Model API Enumerations
Send Feedback on this topic to the authors