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 支持此函数。