DosSetProcCp: Difference between revisions
No edit summary |
|||
| Line 26: | Line 26: | ||
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. | 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 | ===C=== | ||
<PRE> | <PRE> | ||
#define INCL_DOSNLS | #define INCL_DOSNLS | ||
| Line 33: | Line 33: | ||
USHORT rc = DosSetProcCp(CodePage, Reserved); | USHORT rc = DosSetProcCp(CodePage, Reserved); | ||
USHORT | USHORT CodePage; /* Code page identifier */ | ||
USHORT | USHORT 0; /* Reserved, set to zero */ | ||
USHORT | USHORT rc; /* return code */ | ||
</PRE> | </PRE> | ||
===MASM | ===MASM=== | ||
<PRE> | <PRE> | ||
EXTRN DosSetProcCp:FAR | EXTRN DosSetProcCp:FAR | ||
| Line 49: | Line 49: | ||
Returns WORD | Returns WORD | ||
</PRE> | </PRE> | ||
==Related Functions== | ==Related Functions== | ||
* | * | ||
[[Category:Dos]] | [[Category:Dos]] | ||
Revision as of 22:21, 23 December 2017
 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