dos12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
DosSetCp (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSNLS
 
USHORT DosSetCp(usCodePage, usReserved)
USHORT usCodePage;    /* code-page identifier */
USHORT usReserved;    /* must be zero         */
 
The DosSetCp function sets the code-page identifier for the current process.
The code-page identifier defines which translation table the system should
use to translate input from the keyboard or to translate output to the
screen and printer.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
usCodePage  Specifies the code-page identifier. It can be one of the
            following values:
 
            Number  Code page
            ────────────────────────────────────────────────────────────────
            437     United States
 
            850     Multilingual
 
            860     Portuguese
 
            863     French Canadian
 
            865     Nordic
 
usReserved  Specifies a reserved value; must be zero.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value.
 
Comments
 
The DosSetCp function cannot be used to set the code page for a message
queue. To do this, you must use the WinSetCp function.
 
The file system activates the current code page for printer output whenever
the printer is opened.
 
See Also
 
DosGetCp, WinSetCp