IsDBCSLeadByte-Funktion (winnls.h)

Bestimmt, ob ein angegebenes Zeichen ein Leadbyte für die standardmäßige Windows ANSI-Codepage (CP_ACP) des Systems ist. Ein Leadbyte ist das erste Byte eines Zwei-Byte-Zeichens in einem Double-Byte-Zeichensatz (DBCS) für die Codepage.

Hinweis Um eine andere Codepage zu verwenden, sollte Ihre Anwendung die IsDBCSLeadByteEx-Funktion verwenden.

 

Syntax

BOOL IsDBCSLeadByte(
  [in] BYTE TestChar
);

Parameter

[in] TestChar

Das zu überprüfende Zeichen.

Rückgabewert

Gibt einen Wert ungleich 0 (null) zurück, wenn das Testzeichen möglicherweise ein Leadbyte ist. Die Funktion gibt 0 zurück, wenn das Testzeichen kein Leadbyte oder ein Einzelbytezeichen ist. Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastError aufrufen.

Hinweise

Hinweis Diese Funktion überprüft nicht das Vorhandensein oder die Gültigkeit eines Trailbytes. Daher erkennt MultiByteToWideChar möglicherweise keine Sequenz, die die Anwendung mit IsDBCSLeadByte als Leadbyte meldet. Die Anwendung kann leicht mit den Ergebnissen von MultiByteToWideChar nicht synchronisiert werden, was zu unerwarteten Fehlern oder Puffergrößenkonflikten führen kann.

 

Im Allgemeinen sollten Anwendungen anstelle einer Low-Level-Manipulation von Codepagedaten MultiByteToWideChar verwenden, um die Daten in UTF-16 zu konvertieren und mit ihnen in dieser Codierung zu arbeiten.

Lead-Bytewerte sind spezifisch für jedes unterschiedliche DBCS. Einige Bytewerte können in einer einzelnen Codepage sowohl als Lead- als auch als Trail-Byte eines DBCS-Zeichens angezeigt werden.

Um eine DBCS-Zeichenfolge zu verstehen, beginnt eine Anwendung normalerweise am Anfang einer Zeichenfolge und scannt vorwärts, behält den Überblick, wenn sie auf ein führendes Byte trifft, und behandelt das nächste Byte als den nachgestellten Teil desselben Zeichens. Wenn die Anwendung eine Sicherung ausführen muss, sollte sie CharPrev verwenden, anstatt zu versuchen, einen eigenen Algorithmus zu entwickeln.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

IsDBCSLeadByteEx

MultiByteToWideChar

Unicode- und Zeichensatzfunktionen

Unicode und Zeichensätze