Функция 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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