Freigeben über


CharToOemA-Funktion (winuser.h)

Ü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)

Weitere Informationen

CharToOemBuff

Konzept

OemToChar

OemToCharBuff

Referenz

Zeichenfolgen