OemToCharBuffA-Funktion (winuser.h)

Artikel
08/27/2023

Übersetzt eine angegebene Anzahl von Zeichen in einer Zeichenfolge aus dem vom OEM definierten Zeichensatz entweder in eine ANSI- oder eine Breitzeichenzeichenfolge.

Syntax

BOOL OemToCharBuffA(
  [in]  LPCSTR lpszSrc,
  [out] LPSTR  lpszDst,
  [in]  DWORD  cchDstLength
);

Parameter

[in] lpszSrc

Typ: LPCSTR

Mindestens ein Zeichen aus dem vom OEM definierten Zeichensatz.

[out] lpszDst

Typ: LPTSTR

Der Zielpuffer, der die übersetzte Zeichenfolge empfängt. Wenn die OemToCharBuff-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 die OemToCharBuff-Funktion als Breitzeichenfunktion verwendet wird.

[in] cchDstLength

Art: DWORD

Die Anzahl der Zeichen, die in dem durch den lpszSrc-Parameter identifizierten Puffer übersetzt werden sollen.

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

Im Gegensatz zur OemToChar-Funktion beendet die OemToCharBuff-Funktion die Konvertierung von Zeichen nicht, wenn im Puffer ein NULL-Zeichen gefunden wird, auf das von lpszSrc verwiesen wird. Die OemToCharBuff-Funktion konvertiert alle cchDstLength-Zeichen .

Hinweis

Der winuser.h-Header definiert OemToCharBuff 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)