IsNormalizedString-Funktion (winnls.h)

Artikel
08/27/2023

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

Syntax

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

Parameter

[in] NormForm

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

[in] lpString

Zeiger auf die zu testde Zeichenfolge.

[in] cwLength

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

Rückgabewert

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

ERROR_INVALID_PARAMETER. Jeder der Parameterwerte war ungültig.
ERROR_NO_UNICODE_TRANSLATION. In der Zeichenfolge wurde ein ungültiger Unicode-Code gefunden.
ERROR_SUCCESS. Die Aktion wurde erfolgreich abgeschlossen, lieferte aber keine Ergebnisse.

Wenn Sie FALSE aus einer Fehlerbedingung zuverlässig ermitteln müssen, muss SetLastError(ERROR_SUCCESS) aufgerufen werden.

Hinweise

Windows XP, Windows Server 2003:

Wird nicht mehr unterstützt.

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

Beispiele

Ein Beispiel für die Verwendung dieser Funktion finden Sie unter NLS: Unicode-Normalisierungsbeispiel.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	winnls.h (windows.h einschließen)
DLL	Normaliz.dll
Verteilbare Komponente	Microsoft Internationalized Domain Name (IDN)-Entschärfungs-APIs für Windows XP mit SP2 und höher oderWindows Server 2003 mit SP1