CharToOemA-Funktion (winuser.h)

Artikel
03/04/2024

Übersetzt eine Zeichenfolge in den vom OEM definierten Zeichensatz.

Warnung Verwenden Sie nicht. Weitere Informationen finden Sie unter Sicherheitsüberlegungen.

Syntax

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

Parameter

[in] pSrc

Typ: LPCTSTR

Die zu übersetzende NULL-Zeichenfolge.

[out] pDst

Typ: LPSTR

Der Zielpuffer, der die übersetzte Zeichenfolge empfängt. Wenn die CharToOem-Funktion als ANSI-Funktion verwendet wird, kann die Zeichenfolge direkt übersetzt werden, indem der lpszDst-Parameter auf dieselbe Adresse wie der lpszSrc-Parameter festgelegt wird. Dies ist nicht möglich, wenn CharToOem als Breitzeichenfunktion verwendet wird.

Rückgabewert

Typ: BOOL

Der Rückgabewert ist immer nonzero, außer wenn Sie dieselbe Adresse an lpszSrc und lpszDst in der Breitzeichenversion der Funktion übergeben. In diesem Fall gibt die Funktion null und GetLastErrorERROR_INVALID_ADDRESS zurück.

Hinweise

Hinweis

Der winuser.h-Header definiert CharToOem 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 nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-chartranslation-l1-1-0 (eingeführt in Windows 8)