Freigeben über


OemToCharA-Funktion (winuser.h)

Übersetzt eine Zeichenfolge aus dem VOM OEM definierten Zeichensatz entweder in eine ANSI- oder eine Breitzeichenzeichenfolge.

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

Syntax

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

Parameter

[in] pSrc

Typ: LPCSTR

Eine NULL-endende Zeichenfolge mit Zeichen aus dem VOM OEM definierten Zeichensatz.

[out] pDst

Typ: LPTSTR

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

Rückgabewert

Typ: BOOL

Der Rückgabewert ist immer ungleich null, es sei denn, Sie übergeben dieselbe Adresse an lpszSrc und lpszDst in der Breitzeichenversion der Funktion. In diesem Fall gibt die Funktion null und GetLastErrorERROR_INVALID_ADDRESS zurück.

Hinweise

Hinweis

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.

Anforderungen

   
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 (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-chartranslation-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

CharToOem

CharToOemBuff

Konzept

OemToCharBuff

Referenz

Zeichenfolgen