GUI ScreenIO for Windows |
This API transforms data to upper case according to the rules of the alphabet in use on the workstation. Because it is sensitive to foreign alphabets it will work properly with alphabets in all single-byte alphabet countries.
This API will convert data based on the country code/alphabet of the client. If you want to use the setting on the server (which is much more efficient as there is no need to transfer the data to the client across the network) you can select this as follows:
SET WIN32API-EXECUTE-API-ON-SERVER TO TRUE |
Files available to copy to your system:
COPY WIN32API.
|
This field specifies the length of the data you wish to convert. Be sure to set it to the length of the third argument (GSUL-DATA-TO-CONVERT). Setting this field too large can corrupt following field or lead to protection exceptions as the API will try to convert data for the full length specified in this field.
This field is provided for your convenience. To use this field, move the data you wish to convert to this field, call the API, and then move the data back to your source field. In this way, you can be assured that the data will not corrupt your storage. (This does not relieve you of the responsibility of setting GSUL-DATA-LENGTH properly).
NOTE: It may be more efficient and convenient to call this API with the actual data-name that you wish to convert substituted for the field GSUL-DATA-TO-CONVERT. This is perfectly permissible as long as you set the length field properly.
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.
The value returned, (if greater than zero) is the actual number of characters converted.
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 |