OemToCharBuffW-Funktion (winuser.h)

Artikel
11/20/2024

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

Syntax

BOOL OemToCharBuffW(
  [in]  LPCSTR lpszSrc,
  [out] LPWSTR lpszDst,
  [in]  DWORD  cchDstLength
);

Parameter

[in] lpszSrc

Typ: LPCSTR-

Mindestens ein Zeichen aus dem 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 sie den parameter lpszDst auf dieselbe Adresse wie der lpszSrc Parameter festlegen. Dies kann nicht erfolgen, wenn die OemToCharBuff- Funktion als Breitzeichenfunktion verwendet wird.

[in] cchDstLength

Typ: DWORD-

Die Anzahl der Zeichen, die im Puffer übersetzt werden sollen, der durch den lpszSrc Parameter identifiziert 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 zurück, und GetLastError gibt ERROR_INVALID_ADDRESSzurück.

Bemerkungen

Im Gegensatz zur OemToChar--Funktion beendet die OemToCharBuff--Funktion nicht die Konvertierung von Zeichen, wenn ein NULL-Zeichen im Puffer auftritt, auf das lpszSrcverweist. Die OemToCharBuff-funktion konvertiert alle cchDstLength Zeichen.

Anmerkung

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 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll
API-Satz	ext-ms-win-ntuser-chartranslation-l1-1-0 (eingeführt in Windows 8)