Freigeben über


OemToCharA-Funktion (winuser.h)

Übersetzt eine Zeichenfolge aus dem OEM-definierten Zeichensatz in eine ANSI- oder eine Breite-Zeichenfolge.

Warning Do not use. Siehe Sicherheitsüberlegungen.
 

Syntax

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

Parameters

[in] pSrc

Type: LPCSTR

Eine mit Null beendete Zeichenfolge von Zeichen aus dem OEM-definierten Zeichensatz.

[out] pDst

Type: LPTSTR

Der Zielpuffer, der die übersetzte Zeichenfolge empfängt. 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

Die Verwendung dieser Funktion kann die Sicherheit Ihres Programms beeinträchtigen. 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. Weitere Informationen finden Sie unter Sicherheitsüberlegungen: Internationale Features und Sicherheitsüberlegungen: Windows-Benutzeroberfläche.

Note

Der winuser.h-Header definiert OemToChar als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Requirements

Requirement Value
mindestens unterstützte Client- Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server- Windows 2000 Server [nur Desktop-Apps]
Target Platform Windows
Header winuser.h (enthalten Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-chartranslation-l1-1-0 (eingeführt in Windows 8)

See also

CharToOem

CharToOemBuff

Conceptual

OemToCharBuff

Reference

Strings