CharToOemBuffW-Funktion (winuser.h)

Artikel
03/13/2024

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

Syntax

BOOL CharToOemBuffW(
  [in]  LPCWSTR lpszSrc,
  [out] LPSTR   lpszDst,
  [in]  DWORD   cchDstLength
);

Parameter

[in] lpszSrc

Typ: LPCTSTR

Die zu übersetzende NULL-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 ist nicht möglich, 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 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 CharToOem-Funktion beendet die CharToOemBuff-Funktion die Konvertierung von Zeichen nicht, wenn sie auf ein NULL-Zeichen im Puffer stößt, auf den von lpszSrc verwiesen wird. Die CharToOemBuff-Funktion konvertiert alle cchDstLength-Zeichen .

Hinweis

Der winuser.h-Header definiert CharToOemBuff als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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)