Функция EnumSystemCodePagesA (winnls.h)

Статья
11/20/2024

Перечисляет кодовые страницы, установленные или поддерживаемые операционной системой.

Синтаксис

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.

Если приложение использует эту функцию для определения соответствующей кодовой страницы для сохранения данных, он должен использовать Юникод, когда это возможно. Другие кодовые страницы не так переносятся, как Юникод между поставщиками или операционными системами, из-за различных реализаций связанных стандартов.

Заметка

Заголовок winnls.h определяет EnumSystemCodePages как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [классические приложения \| Приложения UWP]
минимальный поддерживаемый сервер	Windows 2000 Server [классические приложения \| Приложения UWP]
целевая платформа	Виндоус
заголовка	winnls.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll

См. также

EnumCodePagesProc

поддержки национальных языков

функции поддержки национальных языков

Поделиться через