db_time_change Function

This function permits clients to notify the server that the time has changed on the client.

Syntax

unsigned int db_time_change(
SQLCA * sqlca);

Parameters

sqlca – A pointer to a SQLCA structure.

Returns

TRUE if successful; FALSE otherwise.

Remarks

This function recalculates the time zone adjustment and sends it to the server. On Windows platforms, it is recommended that applications call this function when they receive the WM_TIMECHANGE message. This will make sure that UTC timestamps are consistent over time changes, time zone changes, or daylight savings time changeovers.