Table of Contents
This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS
Note: This is legacy API call. It is recommended to use 32-bit equivalent
VioGetCp
This call allows a process to query the code page currently used to display text data.
Syntax
VioGetCp (Reserved, CodePageID, VioHandle)
Parameters
- Reserved (USHORT) - input : A reserved word of 0s.
- CodePageID (PUSHORT) - output : Address of a word in the application's data area. The current video code page is returned in this word.
- VioHandle (HVIO) - input : This must be zero unless the caller is a Presentation Manager application, in which case it must be the value returned by VioGetPs.
Return Code
rc (USHORT) - return:Return code descriptions are:
- 0 NO_ERROR
- 355 ERROR_VIO_MODE
- 436 ERROR_VIO_INVALID_HANDLE
- 465 ERROR_VIO_DETACHED
- 468 ERROR_VIO_USER_FONT
Remarks
The display code page ID previously set by VioSetCp, or inherited from the requesting process, is returned to the caller.
The code page tag returned is the currently active code page. A value of 0000 indicates that the code page in use is the ROM code page provided by the hardware.
If ERROR_VIO_USER_FONT is returned, it indicates a user font that was previously loaded with VioSetFont is the active code page.
Bindings
C
#define INCL_VIO USHORT rc = VioGetCp(Reserved, CodePageID, VioHandle); USHORT Reserved; /* Reserved (must be zero) */ PUSHORT CodePageID; /* Code page ID */ HVIO VioHandle; /* Video handle */ USHORT rc; /* return code */
MASM
EXTRN VioGetCp:FAR INCL_VIO EQU 1 PUSH WORD Reserved ;Reserved (must be zero) PUSH@ WORD CodePageID ;Code page ID PUSH WORD VioHandle ;Video handle CALL VioGetCp Returns WORD
Related Functions
Note
Text based on http://www.edm2.com/index.php/VioGetCp_(FAPI)