Compartir a través de


Función OemToCharA (winuser.h)

Traduce una cadena del juego de caracteres definido por EL OEM en una cadena ANSI o de caracteres anchos.

Warning Do not use. Consulte Consideraciones de seguridad.
 

Syntax

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

Parameters

[in] pSrc

Type: LPCSTR

Cadena terminada en NULL de caracteres del conjunto de caracteres definido por OEM.

[out] pDst

Type: LPTSTR

El búfer de destino, que recibe la cadena traducida. 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

El uso incorrecto de esta función podría poner en peligro la seguridad del programa. 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. Para obtener más información, vea Consideraciones de seguridad: Características internacionales y consideraciones de seguridad: Interfaz de usuario de Windows.

Note

El encabezado winuser.h define OemToChar como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requirements

Requirement Value
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
Target Platform Windows
Header winuser.h (incluya Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-chartranslation-l1-1-0 (introducido en Windows 8)

See also

CharToOem

CharToOemBuff

Conceptual

OemToCharBuff

Reference

Strings