GreQueryCodePageVector

GreQueryCodePageVector returns a pointer to a vector of 256 WORDs, which is the code point to the glyph mapping number.

This function is supported by the graphics engine.

Syntax

GreQueryCodePageVector(ulCodePage, pInstance, lFunction)

Parameters

ulCodePage (ULONG) - input

Code page number.

pInstance (PVOID) - input

Pointer to instance data.

lFunction (ULONG) - input

High-order WORD=flags; low-order WORD=NGreQueryCodePageVector.

Returns

rc (PUSHORT) - returns

Return codes.

This function returns a pointer to the code page vector, or it returns GPI_ERROR if an error occurs.

Possible Errors Detected: When an error is detected, the graphics engine calls WinSetErrorInfo to post the condition. Reasons for failure of this function include:

• PMERR_EXCEEDS_MAX_SEG_LENGTH
• PMERR_INSUFFICIENT_MEMORY
• PMERR_INV_CODEPAGE

Refer to the "Error Explanations" section of the Presentation Manager Programming Reference for further explanation.

Sample

#define INCL_GRE_FONTS
#include <os2.h>

ULONG      ulCodePage;  /*  Code page number. */
PVOID      pInstance;   /*  Pointer to instance data. */
ULONG      lFunction;   /*  High-order WORD=flags; low-order WORD=NGreQueryCodePageVector. */
PUSHORT    rc;          /*  Return codes. */

rc = GreQueryCodePageVector(ulCodePage, pInstance, lFunction);