IsNormalizedString, fonction (winnls.h)

Article
08/27/2023

Vérifie qu’une chaîne est normalisée selon Unicode 4.0 TR#15. Pour plus d’informations, consultez Utilisation de la normalisation Unicode pour représenter des chaînes.

Syntaxe

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

Paramètres

[in] NormForm

Formulaire de normalisation à utiliser. NORM_FORM spécifie les formulaires de normalisation Unicode standard.

[in] lpString

Pointeur vers la chaîne à tester.

[in] cwLength

Longueur, en caractères, de la chaîne d’entrée, y compris un caractère de fin null. Si cette valeur est -1, la fonction suppose que la chaîne est terminée par null et calcule automatiquement la longueur.

Valeur retournée

Retourne TRUE si la chaîne d’entrée est déjà normalisée au format approprié, ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner l’un des codes d’erreur suivants :

ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.
ERROR_NO_UNICODE_TRANSLATION. Unicode non valide a été trouvé dans string.
ERROR_SUCCESS. L’action s’est terminée avec succès, mais n’a produit aucun résultat.

Si vous devez déterminer de manière fiable FALSE à partir d’une condition d’erreur, il doit appeler SetLastError(ERROR_SUCCESS).

Remarques

Windows XP, Windows Server 2003 :

N'est plus pris en charge.

Le fichier d’en-tête et la DLL requis font partie des API d’atténuation des noms de domaine internationalisés (IDN) Microsoft, qui ne sont plus disponibles en téléchargement.

Exemples

Vous trouverez un exemple montrant l’utilisation de cette fonction dans NLS : Exemple de normalisation Unicode.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
DLL	Normaliz.dll
Composant redistribuable	API d’atténuation des noms de domaine internationalisés (IDN) Microsoft surWindows XP avec SP2 et versions ultérieures, ouWindows Server 2003 avec SP1