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

Статья
11/20/2024

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

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

Синтаксис

BOOL CharToOemW(
  [in]  LPCWSTR pSrc,
  [out] LPSTR   pDst
);

Параметры

[in] pSrc

Тип: LPCTSTR

Прерванная со значением NULL строка, которая будет преобразована.

[out] pDst

Тип: LPSTR

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

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

Тип: BOOL

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	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)