DosSetProcCp

Legacy Function Warning
It is recommended to use a newer replacement for this function.
Replacement:	DosSetProcessCp
Remarks:	This function was renamed to DosSetProcessCp on OS/2 2.0.

This call allows a process to set its code page.

Syntax

DosSetProcCp (CodePage, Reserved)

Parameters

CodePage (USHORT) - input

Code page identifier word that has one of the following values:

437 - IBM PC US 437 code page
850 - Multilingual code page
860 - Portuguese code page
863 - Canadian-French code page
865 - Nordic code page

Reserved (USHORT) - input: Reserved must be set to zero.

Return Code

rc (USHORT) - return

Return code description is:

0 NO_ERROR
472 ERROR_INVALID_CODEPAGE

Remarks

DosSetProcCp sets the process code page of the calling process. The code page of a process is used in the following ways. First, the printer code page is set to the process code page through the file system and printer spooler when the process makes an open printer request. Calling DosSetProcCp does not affect the code page of a printer opened prior to the call and does not affect the code page of a printer opened by another process. Second, country dependent information, by default, is retrieved encoded in the code page of the calling process. And third, a newly created process inherits its process code page from its parent process. DosSetProcCp does not affect the display or keyboard code page. Also see DosSetCp.

Bindings

C

#define INCL_DOSNLS

USHORT  rc = DosSetProcCp(CodePage, Reserved);

USHORT  CodePage;      /* Code page identifier */
USHORT  0;             /* Reserved, set to zero */

USHORT  rc;            /* return code */

MASM

EXTRN  DosSetProcCp:FAR
INCL_DOSNLS         EQU 1

PUSH   WORD    CodePage      ;Code page identifier
PUSH   WORD    0             ;Reserved (must be zero)
CALL   DosSetProcCp

Returns WORD

Related Functions