Функция OemToCharA (winuser.h)

Статья
11/20/2024

Преобразует строку из определяемого изготовителем символа в anSI или строку с расширенным символом.

предупреждение не использовать. Ознакомьтесь с рекомендациями по безопасности.

Синтаксис

BOOL OemToCharA(
  [in]  LPCSTR pSrc,
  [out] LPSTR  pDst
);

Параметры

[in] pSrc

Тип: LPCSTR

Строка символов, завершающаяся значением NULL, из определяемого изготовителем набора символов.

[out] pDst

Тип: LPTSTR

Буфер назначения, который получает преобразованную строку. Если функция oemToChar используется в качестве функции ANSI, строка может быть преобразована на месте, задав параметр lpszDst на тот же адрес, что и параметр lpszSrc. Это невозможно сделать, если OemToChar используется в качестве функции широкого символа.

Возвращаемое значение

Тип: BOOL

Возвращаемое значение всегда ненулевое, за исключением случаев, когда вы передаете тот же адрес lpszSrc и lpszDst в широкой версии функции. В этом случае функция возвращает ноль и возвращает GetLastError возвращает ERROR_INVALID_ADDRESS.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll
набор API	ext-ms-win-ntuser-chartranslation-l1-1-0 (представлено в Windows 8)