Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Convierte una cadena en el juego de caracteres definido por OEM.
Syntax
BOOL CharToOemA(
[in] LPCSTR pSrc,
[out] LPSTR pDst
);
Parameters
[in] pSrc
Type: LPCTSTR
Cadena terminada en NULL que se va a traducir.
[out] pDst
Type: LPSTR
El búfer de destino, que recibe la cadena traducida. If the CharToOem 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 CharToOem 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 CharToOem 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
Conceptual
Reference