ConvertSystemTimeToCalDateTime

  • Article

Converts a specified SYSTEMTIME structure to a CALDATETIME structure.

BOOL ConvertSystemTimeToCalDateTime(const SYSTEMTIME   *lpSysTime,CALID          calId,LPCALDATETIME  lpCalDateTime);

Parameters

  • lpSysTime
    [in] Pointer to the SYSTEMTIME structure to be converted.
  • calId
    [in] The system calendar Calendar identifier to use in the conversion.
  • lpCalDateTime
    [out] The equivalent CALDATETIME structure.

Return Values

Returns TRUE if successful.

Returns FALSE if the conversion did not succeed.

Remarks

To get extended error information, call GetLastError, which can return the following error code:

  • ERROR_INVALID_PARAMETER

The earliest date supported by this function is January 1, 1601.

This function does not have an associated header or library file. Call LoadLibrary with the DLL name (Kernel32.dll) to obtain a module handle. Then call GetProcAddress with that module handle and this function name to get the address of this function.

This function is deprecated and will be unavailable in subsequent versions.

Requirements

**  Windows NT/2000/XP/Vista:** Windows Vista only.
**  Windows 95/98/Me:** Unsupported.
**  Implementation:** Implemented by Kernel32.dll.

See Also

National Language Support Functions, Retrieving Time and Date Information