GUI ScreenIO for Windows |
The GetSystemTime API retrieves the System time in Universal Coordinated Time (UTC) format.
This is useful for comparing File Times retrieved by GetFileTime or FindFirst APIs which use the exact same format.
This implementation of the API provides the Date and Time in a format that has year, month, day-of-week, day, hour, minute, second, and millisecond.
The API may be used to access files on either the client or the server. To interrogate a file on the server:
SET WIN32API-EXECUTE-API-ON-SERVER TO TRUE |
Note: Since all systems report UTC time and difference in the System Time returned by a Client from the Time on the Server are due to inaccurate clock settings. This imprecision should be considered if you are fetching times on remote systems to determine which has the most recent version of a particular file.
Files available to copy to your system:
COPY WIN32API.
|
This data structure returns the date and time in Windows System Time format. UTC time. The following sub-definitions are provided:
ST-YEAR
ST-MONTH
ST-DAY-OF-WEEK
ST-DAY
ST-HOUR
ST-MINUTE
ST-SECOND
ST-HUNDREDTHS
This argument is standard for all CALLs to GSWINAPI. It is used to select the desired API or function, and to return the status of the operation.
Used to return the status of a call to GSWINAPI. A value of zero is a failure, any other value indicates success.
Recommended usage is to test the 88-level value WIN32API to see if it worked, then to use the text error message to see why it failed.
* ------------------------: If function failed,
|
Error code that was returned by Windows. This is not generally useful unless you have the Windows Platform SDK documentation available to you.
Plain-text error message that describes why the operation failed.
The number of these present varies depending on how many arguments are used by the desired function. These are not used, but must be present because this CALL requires seven arguments.
© 2000-2019 Norcom, all rights reserved |