enumSystemCodePagesA 函数 (winnls.h)

  • 项目

枚举安装在操作系统上或受操作系统支持的代码页。

语法

BOOL EnumSystemCodePagesA(
  [in] CODEPAGE_ENUMPROCA lpCodePageEnumProc,
  [in] DWORD              dwFlags
);

参数

[in] lpCodePageEnumProc

指向应用程序定义的回调函数的指针。 EnumSystemCodePages 函数通过重复调用此回调函数来枚举代码页。 有关详细信息，请参阅 EnumCodePagesProc。

[in] dwFlags

指定要枚举的代码页的标志。 此参数可以具有以下值之一，这些值是互斥的。

值 含义
CP_INSTALLED
 仅枚举已安装的代码页。
CP_SUPPORTED
 枚举所有受支持的代码页。

返回值

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

  • ERROR_BADDB。 函数无法访问数据。 这种情况通常不应发生，通常表示安装错误、磁盘问题或类似问题。
  • ERROR_INVALID_FLAGS。 为标志提供的值无效。
  • ERROR_INVALID_PARAMETER。 任何参数值都无效。

注解

此函数通过将代码页标识符（一次一个）传递到指定的应用程序定义的回调函数来枚举代码页。 此过程一直持续到所有已安装或支持的代码页标识符都传递给回调函数，或者回调函数返回 FALSE。

当应用程序使用此函数确定用于保存数据的相应代码页时，应尽可能使用 Unicode。 由于相关标准的实现不同，其他代码页不像供应商或操作系统之间的 Unicode 那样可移植。

注意

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

要求

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

另请参阅

EnumCodePagesProc

国家语言支持

国家语言支持函数