Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ü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) |
Weitere Informationen
Konzept
Referenz