getCPInfoExA 函数 (winnls.h)

检索有关任何有效的已安装或可用代码页的信息。

语法

BOOL GetCPInfoExA(
  [in]  UINT        CodePage,
  [in]  DWORD       dwFlags,
  [out] LPCPINFOEXA lpCPInfoEx
);

参数

[in] CodePage

要检索其信息的代码页的标识符。 应用程序可以为任何已安装或可用的代码页指定代码页标识符,或者指定以下预定义值之一。 有关 ANSI 和其他 代码页 的标识符列表,请参阅代码页标识符。

含义
CP_ACP
使用系统默认的 Windows ANSI 代码页。
CP_MACCP
使用系统默认的 Macintosh 代码页。
CP_OEMCP
使用系统默认的 OEM 代码页。
CP_THREAD_ACP
使用当前线程的 ANSI 代码页。

[in] dwFlags

保留;必须为 0。

[out] lpCPInfoEx

指向接收代码页相关信息的 CPINFOEX 结构的指针。

返回值

如果成功,则返回非零值,否则返回 0。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

  • ERROR_INVALID_PARAMETER。 任何参数值都无效。

注解

CPINFOEX 结构中检索的信息并不总是对所有代码页都有用。 例如,若要确定缓冲区大小,应用程序应调用 MultiByteToWideCharWideCharToMultiByte 来请求准确的缓冲区大小。 如果 CPINFOEX 设置指示存在前导字节,则转换函数不一定以不同的方式处理前导字节,例如,在缺失或非法的尾随字节的情况下。

注意

winnls.h 标头将 GetCPInfoEx 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

CPINFOEX

GetACP

GetCPInfo

GetOEMCP

国家/地区语言支持

国家/地区语言支持函数