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

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

Warning Do not use. Ознакомьтесь с рекомендациями по безопасности.
 

Syntax

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

Parameters

[in] pSrc

Type: LPCSTR

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

[out] pDst

Type: LPTSTR

Буфер назначения, который получает преобразованную строку. If the OemToChar function is being used as an ANSI function, the string can be translated in place by setting the lpszDst parameter to the same address as the lpszSrc parameter. This cannot be done if OemToChar is being used as a wide-character function.

Return value

Type: BOOL

The return value is always nonzero except when you pass the same address to lpszSrc and lpszDst in the wide-character version of the function. In this case the function returns zero and GetLastError returns ERROR_INVALID_ADDRESS.

Remarks

Security Considerations

Неправильное использование этой функции может нарушить безопасность программы. For example, miscalculating the proper size of the lpszDst buffer, especially when the application is used in both ANSI and Unicode versions, can cause a buffer overflow. Дополнительные сведения см. в статье "Вопросы безопасности: международные функции и вопросы безопасности: пользовательский интерфейс Windows".

Note

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

Requirements

Requirement Value
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
Target Platform Windows
Header winuser.h (включая Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-chartranslation-l1-1-0 (представлено в Windows 8)

See also

CharToOem

CharToOemBuff

Conceptual

OemToCharBuff

Reference

Strings