GetCPInfoExA 函数（winnls.h）

项目
11/20/2024

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

语法

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 结构中检索的信息并非总是适用于所有代码页。例如，若要确定缓冲区大小，应用程序应调用 MultiByteToWideChar 或 WideCharToMultiByte 来请求准确的缓冲区大小。如果 CPINFOEX 设置指示存在铅字节，则转换函数不一定以不同的方式处理潜在顾客字节，例如，在缺少或非法的尾随字节的情况下。

注意

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

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [桌面应用 \|UWP 应用]
支持的最低服务器	Windows 2000 Server [桌面应用 \|UWP 应用]
目标平台	窗户
标头	winnls.h （包括 Windows.h）
库	Kernel32.lib
DLL	Kernel32.dll