ConvertCalDateTimeToSystemTime function

Article
01/07/2021

Deprecated. Converts a specified CALDATETIME structure to a SYSTEMTIME structure.

Syntax

BOOL ConvertCalDateTimeToSystemTime(
  _In_  const LPCALDATETIME lpCalDateTime,
  _Out_       SYSTEMTIME    *lpSysTime
);

Parameters

lpCalDateTime [in]: Pointer to the CALDATETIME structure to convert.
lpSysTime [out]: Pointer to the equivalent SYSTEMTIME structure.

Return value

Returns TRUE if successful or FALSE otherwise. To get extended error information, the application can call GetLastError, which can return one of the following error codes:

ERROR_DATE_OUT_OF_RANGE. The specified date was out of range.
ERROR_INVALID_PARAMETER. Any of the parameter values was invalid.

Remarks

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

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
DLL	Kernel32.dll