DosGetCtryInfo

This call obtains country-dependent formatting information that resides in the country information file.

DosGetCtryInfo

(Length, Country, MemoryBuffer, DataLength)

Length (USHORT) - input

Length, in bytes, of the data area (MemoryBuffer). This length should be at least 38 bytes.
Country (PCOUNTRYCODE) - input
Address of the country information structure:

country (USHORT)

Country code identifier; 0 is the default country code.
codepage (USHORT)
Code page identifier; 0 is the code page of the current process.
MemoryBuffer (PCOUNTRYINFO) - output
Address of the buffer where the country-dependent data is returned. The application must request enough space in memory, a minimum of 38 bytes, to hold the returned data. If the requested space is not large enough, the system fills the allocated space with as much data as it can hold. If the requested space is too large, the extra memory requested is set to 0. The data is returned in the buffer in the following format:

country (USHORT)

Country code identifier.
codepage (USHORT)
Code page identifier.
dateformat (USHORT)
Date format.

Value

Definition
0
mm/dd/yy
1
dd/mm/yy
2
yy/mm/dd
currency (CHAR)
Currency identifier, terminated with a null.
thousandsep (CHAR)
Thousands separator, terminated with a null.
decimalsep (CHAR)
Decimal separator, terminated with a null.
datesep (CHAR)
Date separator, terminated with a null.
timesep (CHAR)
Time separator, terminated with a null.
currencyformat (UCHAR)
The currency bit fields in the following format:

Bit

Description
7-3
Reserved
2
0 = Bits 0 and 1 are used.

1 = Bits 0 and 1 are ignored; the currency indicator replaces the decimal indicator.

1
0 = No space between the currency indicator and money value.

1 = One space between the currency indicator and money value.

0
0 = Currency indicator precedes the money value.

1 = Currency indicator follows the money value.

decimalspace (UCHAR)
Number (in binary) of decimal spaces used to indicate currency value.
timeformat (UCHAR)
Time format for presentation in file directory:

Bit

Description
7-1
Reserved
0
0 = 12-hour format

1 = 24-hour format.

reserved (USHORT)
Reserved, set to zero.
datalistsep (CHAR)
Data list separator, terminated with a null.
reserved (USHORT)
Reserved, set to zero.
DataLength (PUSHORT) - output
Address of the length, in bytes, of the country dependent information.
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

  The returned country dependent information may be for the default country and current process code page, or for a specific country and code page. For more information on code page, see DosSetCp.

  
  Family API Considerations

  Some options operate differently in DOS mode than in OS/2 mode. Note that not all country information is available in DOS 3.3.

  ---

  [Back: DosGetCp]
  [Next: DosGetDateTime]