DosCaseMap
Bindings: C, MASM
This call performs case mapping on a string of binary values that
represent ASCII characters.
DosCaseMap (Length, Country, BinaryString)
Length (USHORT) - input
Length of the string of binary values to be case mapped.
Country (PCOUNTRYCODE) - input/output
Address of the country information structure:
country (USHORT)
Country code identifier is a binary value of the selected country
code. 0 is the default country code.
codepage (USHORT)
Code page identifier is a binary value of the selected code page. 0
is the code page of the current process.
BinaryString (PCHAR) - input/output
Address of a string of binary characters to be case mapped. They are
case mapped in place so the results appear in BinaryString and the
input is destroyed.
rc (USHORT) - return
Return code descriptions are:
0 NO_ERROR
396 ERROR_NLS_NO_COUNTRY_FILE
397 ERROR_NLS_OPEN_FAILED
398 ERROR_NO_COUNTRY_OR_CODEPAGE
399 ERROR_NLS_TABLE_TRUNCATED
Remarks
DosCaseMap is mainly used to map a lower case character string to an
upper case character string. Unless the user replaces the country
information file, DosCaseMap only does the conversion from lower case to
upper case.
The case map information is taken from the country information file. See
the COUNTRY statement in the IBM Operating System/2 Version 1.2 Command
Reference for information on how to specify the country information file.
If countrycode is 0, the case mapping is performed using the information
for the country specified in the COUNTRY statement in CONFIG.SYS.
If countrycode is not 0, the case mapping is performed using the
information for that country.
If the code page identifier is 0, the case mapping is performed using the
information for the current process code page. Refer to DosSetCp and the
CHCP command in the IBM Operating System/2 Version 1.2 Command Reference
for information on setting the process code page. If codepage is not 0,
the case mapping is performed using the information for that code page.
The returned country dependent information may be for the default country
and current process code page or for a specific country and code page.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs