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