Freigeben über

IsNormalizedString-Funktion (winnls.h)

Überprüft, ob eine Zeichenfolge gemäß Unicode 4.0 TR#15 normalisiert wird. Weitere Informationen finden Sie unter Verwenden der Unicode-Normalisierung zur Darstellung von Zeichenfolgen.

Syntax

BOOL IsNormalizedString(
  [in] NORM_FORM NormForm,
  [in] LPCWSTR   lpString,
  [in] int       cwLength
);

Die Parameter

[in] NormForm

Zu verwendende Normalisierungsformular. NORM_FORM gibt die standardmäßigen Unicode-Normalisierungsformulare an.

[in] lpString

Zeigen Sie auf die zu testde Zeichenfolge.

[in] cwLength

Länge der Eingabezeichenfolge in Zeichen, einschließlich eines Null-Endzeichens. Wenn dieser Wert -1 ist, geht die Funktion davon aus, dass die Zeichenfolge null-beendet ist, und berechnet die Länge automatisch.

Rückgabewert

Gibt WAHR zurück, wenn die Eingabezeichenfolge bereits auf das entsprechende Formular normalisiert ist oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, kann die Anwendung GetLastErroraufrufen, wodurch eine der folgenden Fehlercodes zurückgegeben werden kann:

  • ERROR_INVALID_PARAMETER. Ungültige Parameterwerte.
  • ERROR_NO_UNICODE_TRANSLATION. Ungültiges Unicode wurde in Zeichenfolge gefunden.
  • ERROR_SUCCESS. Die Aktion wurde erfolgreich abgeschlossen, lieferte aber keine Ergebnisse.
Wenn Sie FALSE zuverlässig anhand einer Fehlerbedingung ermitteln müssen, muss setLastError(ERROR_SUCCESS) aufgerufen werden.

Bemerkungen

Windows XP, Windows Server 2003:

Wird nicht mehr unterstützt.

Die erforderliche Headerdatei und DLL sind Teil der MICROSOFT Internationalized Domain Name (IDN)-Entschärfungs-APIs, die nicht mehr zum Download verfügbar sind.

Examples

Ein Beispiel für die Verwendung dieser Funktion finden Sie in NLS: Unicode Normalization Sample.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header winnls.h (enthalten Windows.h)
Library kernel32. Befreien
DLL Normaliz.dll
Weiterverteilbar Microsoft Internationalized Domain Name (IDN) Mitigation APIs onWindows XP with SP2 and later, orWindows Server 2003 with SP1

Siehe auch

NORM_FORM

Funktionen

NormalizeString

Verwenden der Unicode-Normalisierung zur Darstellung von Zeichenfolgen

  • Last updated on