CharToOemBuffA-Funktion (winuser.h)

Artikel
03/13/2024

Übersetzt eine angegebene Anzahl von Zeichen in einer Zeichenfolge in den VOM OEM definierten Zeichensatz.

Syntax

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

Parameter

[in] lpszSrc

Typ: LPCTSTR

Die zu übersetzende NULL-endende Zeichenfolge.

[out] lpszDst

Typ: LPSTR

Der Puffer für die übersetzte Zeichenfolge. Wenn die CharToOemBuff-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 kann nicht erfolgen, wenn CharToOemBuff als Breitzeichenfunktion verwendet wird.

[in] cchDstLength

Art: DWORD

Die Anzahl der zu übersetzenden Zeichen in der durch den lpszSrc-Parameter identifizierten Zeichenfolge.

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

Im Gegensatz zur CharToOem-Funktion beendet die CharToOemBuff-Funktion die Konvertierung von Zeichen nicht, wenn im Puffer, auf den lpszSrc verweist, ein NULL-Zeichen gefunden wird. Die CharToOemBuff-Funktion konvertiert alle cchDstLength-Zeichen .

Hinweis

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

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