GetCodePage

SNA 国家/地区语言支持 (SNANLS) GetCodePage 函数将键标识的代码页信息复制到作为参数传递的结构。

语法

  
BOOL WINAPI GetCodePage(   
        Int nKey  
struct CodePage *pPage  
);  

参数

nKey
提供的参数。 代码页的数字键。 此值是包含 SNANLS 支持的代码页的数组中的不透明索引。 此值通常是从先前调用 FindFirstCodePage 或 FindNextCodePage 返回的 CodePage 结构的 CodePageKey 成员。

pPage
提供并返回的参数。 指向应复制代码页信息的结构 CodePage 的指针。

成功返回后,此参数指向的内存位置将填充特定代码页的信息。

失败时,不会对此参数指向的内存进行更改。

CodePage 结构在 SNANLS 中定义。H include 文件,如下所示:

struct CodePage {  
    BYTE    CodePageKey;  
    DWORD   CodePageID;  
    WCHAR   szFriendlyName[CP_SIZE];  
    short   eGroup;  
    BOOL    bAvailable;  
    BYTE    bccsid;  
    BOOL    bEuro;  
};  

此 CodePage 结构的成员如下所示:

CodePageKey

一个数值,表示 CodePage 结构数组中的索引。 此值应用作不透明值,因为当支持其他代码页时,Service Pack 可以任意更改此值。

CodePageID

NLS 代码页码。

szFriendlyName

此代码页的 SNANLS 显示名称。 字符串以 null 结尾。

eGroup

此代码页所表示的组。 .此值可以是代码组的 SNANLS.h include 文件中定义的下列枚举之一:

ENUM_CP_EBCDIC

此代码页是 EBCDIC 代码页组的成员。

ENUM_CP_ANSI

此代码页是 ANSI 代码页组的成员。

ENUM_CP_ISO

此代码页是 ISO 代码页组的成员。

ENUM_CP_OEMPC

此代码页是 OEM 电脑代码页组的成员。

ENUM_CP_ISO

此代码页是 ISO 代码页组的成员。

ENUM_CP_ISO

此代码页是 ISO 代码页组的成员。

ENUM_CP_OEM电脑

此代码页是 OEM 电脑代码页组的成员。

ENUM_CP_OPEN

此代码页是 Open Systems 代码页组的成员。

ENUM_CP_UCS

此代码页是 UCS 代码页组的成员。

bAvailable

一个布尔值,用于指示计算机上已安装此代码页。 此成员的 值为 FALSE 表示不会查询计算机以确定是否安装了此代码页。 值为 TRUE 表示已安装代码页。

bccsid

用于指示代码页类型的标志。 此标志可以是下列标志之一:

ENUM_CP_DBCS (0x08)

代码页适用于双字节字符集。

ENUM_CP_MBCS (0x10)

代码页适用于混合字节字符集。

ENUM_CP_SBCS (0x20)

代码页适用于单字节字符集。

bEuro

一个布尔值,用于指示此代码页是否支持欧元符号。 如果此值为 TRUE,则支持欧元符号。

返回值

GetCodePage 函数在成功时返回值为 TRUE。 失败时,返回的值为 FALSE

注解

主机集成服务器上的 SNANLS 支持此函数。