GUI ScreenIO for Windows

 ScreenIO.com


GetSystemTime

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.

Client/Server issues

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

Files available to copy to your system:

Usage

     COPY WIN32API.
     COPY SYSTIME.

* ------------------------: Call the API.

     SET API-GETSYSTEMTIME TO TRUE.

     CALL 'GSWINAPI' USING WIN32API-PARMS
                           SYSTEM-TIME
                           WIN32API-B
                           WIN32API-C
                           WIN32API-D
                           WIN32API-E
                           WIN32API-F.

Parameters specific to this function

SYSTEM-TIME

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

WIN32API-PARMS - Used in all GSWINAPI calls

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.

WIN32API-RC

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,
*                         :   display the error in a message box.
*
     IF WIN32API-FAILED
       MOVE WIN32API-ERROR-TEXT TO panel-MESSAGE-TEXT
       SET panel-MESSAGE-IN-MESSAGEBOX TO TRUE.

WIN32API-ERROR-CODE

Error code that was returned by Windows.  This is not generally useful unless you have the Windows Platform SDK documentation available to you.

WIN32API-ERROR-TEXT

Plain-text error message that describes why the operation failed.

WIN32API-A through WIN32API-F

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-2006 Norcom, all rights reserved 

TOC

Send feedback to Norcom