DosCaseMap

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:
• 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.

  ---

  [Back: DosCallNmPipe]
  [Next: DosChDir]