DosQueryDBCSEnv - Parameters

cb (ULONG) - input

The length, in bytes, of the data area (pBuf) provided by the caller.

A length value of 12 bytes is sufficient. The caller can always determine if all of the information has been obtained, because it ends with four bytes of 0s. A length of 4 is sufficient for information returned from non-DBCS-related countries.

pcc (PCOUNTRYCODE) - input

A pointer to the COUNTRYCODE structure in which the country code and code page are identified.

If country is set to 0, the DBCS information for the default system country code is returned.

If codepage is set to 0, the DBCS information for the current process code page of the caller is returned.

Refer to the COUNTRYCODE for a table of values for country code and code page identifier.

pBuf (PCHAR) - output

The data area where the country-dependent information for the DBCS environmental vector is returned.

The caller provides this memory area. The size of the area is specified by the input parameter cb.

If this area is too small to hold all of the available information, then as much information as possible is provided in the available space (in the order in which the data would appear). Assuming that the data area is large enough, the valid information is terminated by two bytes of 0. The format of the information returned in this buffer is as follows:

• Bytes
  First range definition for DBCS lead byte values:

  Byte 1

  binary start value (inclusive) for range one
  Byte 2
  binary stop value (inclusive) for range one
  2 Bytes
  Second range definition:

  Byte 1

  binary start value for range two
  Byte 2
  binary stop value for range two
  2 Bytes
  Nth range definition:

  Byte 1

  binary start value for Nth range
  Byte 2
  binary stop value for Nth range
  2 Bytes
  Two bytes of binary 0 end the list.

  For example: DB   81H,9FH
               DB   E0H,FCH
               DB   0,0
  
  

  ulrc (APIRET) - returns

  Return Code.

  DosQueryDBCSEnv returns one of the following values:

  • NO_ERROR 397
    ERROR_NLS_OPEN_FAILED
    398
    ERROR_NLS_NO_CTRY_CODE
    399
    ERROR_NLS_TABLE_TRUNCATED
    401
    ERROR_NLS_TYPE_NOT_FOUND
    476
    ERROR_CODE_PAGE_NOT_FOUND
    For a full list of error codes, see Errors.

  ---

  [Back: DosQueryDBCSEnv Return Value - ulrc]
  [Next: DosQueryDBCSEnv - Remarks]