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.
DosSetProcCp (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_DOSNLS
 
USHORT DosSetProcCp(usCodePage, usReserved)
USHORT usCodePage;    /* code-page identifier  */
USHORT usReserved;    /* must be zero          */
 
The DosSetProcCp function allows a process to set its code page.
 
Parameter   Description
────────────────────────────────────────────────────────────────────────────
 
usCodePage  Specifies a code-page-identifier word that has 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
 
This function sets the process code page of the calling process. The code
page of a process is used in three ways. First, the printer code page is set
to the process code page through the file system and Printer spooler (the
system spooler must be installed) when the process makes a request to open
the printer. Calling DosSetProcCp does not affect the code page of a printer
opened before the call, nor does it affect the code page of a printer opened
by another process. Second, country-dependent information will, by default,
be retrieved encoded in the code page of the calling process. Third, a newly
created process inherits its process code page from its parent process.
 
DosSetProcCp does not affect the screen or keyboard code page.
 
See Also
 
DosSetCp