IsTextUnicode-Funktion (winbase.h)

Artikel
03/03/2024

Bestimmt, ob ein Puffer wahrscheinlich eine Form von Unicode-Text enthält.

Syntax

BOOL IsTextUnicode(
  [in]                const VOID *lpv,
  [in]                int        iSize,
  [in, out, optional] LPINT      lpiResult
);

Parameter

[in] lpv

Zeiger auf den zu untersuchenden Eingabepuffer.

[in] iSize

Größe des durch lpv angegebenen Eingabepuffers in Bytes.

[in, out, optional] lpiResult

Zeigen Sie bei der Eingabe auf die Tests, die auf den Eingabepuffertext angewendet werden sollen. Bei der Ausgabe empfängt dieser Parameter die Ergebnisse der angegebenen Tests: 1, wenn der Inhalt des Puffers einen Test bestanden hat, 0 für Fehler. Nur Flags, die bei der Eingabe an die Funktion festgelegt werden, sind bei der Ausgabe von Bedeutung.

Wenn lpiResultNULL ist, verwendet die Funktion alle verfügbaren Tests, um zu bestimmen, ob die Daten im Puffer wahrscheinlich Unicode-Text sind.

Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen. Werte können mit dem binären "OR" kombiniert werden.

Wert	Bedeutung
IS_TEXT_UNICODE_ASCII16	Der Text ist Unicode und enthält nur erweiterte ASCII-Werte/Zeichen mit Null.
IS_TEXT_UNICODE_REVERSE_ASCII16	Identisch mit dem vorherigen Text, mit der Ausnahme, dass der Unicode-Text byteumgekehrt ist.
IS_TEXT_UNICODE_STATISTICS	Der Text ist wahrscheinlich Unicode, wobei die Bestimmung durch die Anwendung statistischer Analyse vorgenommen wird. Absolute Sicherheit ist nicht garantiert. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.
IS_TEXT_UNICODE_REVERSE_STATISTICS	Identisch mit dem vorherigen, mit dem Unterschied, dass der Text, der wahrscheinlich Unicode ist, byteumgekehrt ist.
IS_TEXT_UNICODE_CONTROLS	Der Text enthält Unicode-Darstellungen eines oder mehrerer dieser Nichtdruckzeichen: RETURN, LINEFEED, SPACE, CJK_SPACE, TAB.
IS_TEXT_UNICODE_REVERSE_CONTROLS	Identisch mit dem vorherigen, mit der Ausnahme, dass die Unicode-Zeichen byteumgekehrt sind.
IS_TEXT_UNICODE_BUFFER_TOO_SMALL	Der Puffer enthält zu wenige Zeichen für eine aussagekräftige Analyse (weniger als zwei Bytes).
IS_TEXT_UNICODE_SIGNATURE	Der Text enthält die Unicode-Byte-Order-Markierung (BOM) 0xFEFF als erstes Zeichen.
IS_TEXT_UNICODE_REVERSE_SIGNATURE	Der Text enthält die Unicode-Byte-Reverse-Order-Markierung (Reverse BOM) 0xFFFE als erstes Zeichen.
IS_TEXT_UNICODE_ILLEGAL_CHARS	Der Text enthält eines dieser ungültigen Unicode-Zeichen: eingebettete reverse BOM, UNICODE_NUL, CRLF (in ein Wort gepackt) oder 0xFFFF.
IS_TEXT_UNICODE_ODD_LENGTH	Die Anzahl der Zeichen in der Zeichenfolge ist ungerade. Eine Zeichenfolge ungerade Länge darf (per Definition) nicht Unicode-Text sein.
IS_TEXT_UNICODE_NULL_BYTES	Der Text enthält NULL-Bytes, die auf Nicht-ASCII-Text hinweisen.
IS_TEXT_UNICODE_UNICODE_MASK	Der Wert ist eine Kombination aus IS_TEXT_UNICODE_ASCII16, IS_TEXT_UNICODE_STATISTICS, IS_TEXT_UNICODE_CONTROLS, IS_TEXT_UNICODE_SIGNATURE.
IS_TEXT_UNICODE_REVERSE_MASK	Der Wert ist eine Kombination aus IS_TEXT_UNICODE_REVERSE_ASCII16, IS_TEXT_UNICODE_REVERSE_STATISTICS, IS_TEXT_UNICODE_REVERSE_CONTROLS, IS_TEXT_UNICODE_REVERSE_SIGNATURE.
IS_TEXT_UNICODE_NOT_UNICODE_MASK	Der Wert ist eine Kombination aus IS_TEXT_UNICODE_ILLEGAL_CHARS, IS_TEXT_UNICODE_ODD_LENGTH und zwei derzeit nicht verwendeten Bitflags.
IS_TEXT_UNICODE_NOT_ASCII_MASK	Der Wert ist eine Kombination aus IS_TEXT_UNICODE_NULL_BYTES und drei derzeit nicht verwendeten Bitflags.

Rückgabewert

Gibt einen Ungleichwert zurück, wenn die Daten im Puffer die angegebenen Tests bestanden. Die Funktion gibt 0 zurück, wenn die Daten im Puffer die angegebenen Tests nicht bestehen.

Hinweise

Diese Funktion verwendet verschiedene statistische und deterministische Methoden, um ihre Bestimmung unter der Kontrolle von Flags zu treffen, die im lpiResult-Parameter übergeben werden. Wenn die Funktion zurückgibt, werden die Ergebnisse solcher Tests mit demselben Parameter gemeldet.

Die IS_TEXT_UNICODE_STATISTICS und IS_TEXT_UNICODE_REVERSE_STATISTICS Tests verwenden statistische Analysen. Diese Tests sind nicht narrensicher. Bei den statistischen Tests wird davon ausgegangen, dass bestimmte Mengen an Variationen zwischen niedrigen und hohen Bytes in einer Zeichenfolge vorhanden sind, und einige ASCII-Zeichenfolgen können durchrutschen. Wenn lpv beispielsweise die ASCII-Zeichenfolge 0x41, 0x0A, 0x0D, 0x1D (A\n\r^Z) angibt, besteht die Zeichenfolge den IS_TEXT_UNICODE_STATISTICS-Test, obwohl ein Fehler vorzuziehen wäre.

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	winbase.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

Unicode- und Zeichensatzfunktionen

Unicode- und Zeichensätze

Share via