Fonction IsNormalizedString (winnls.h)

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 une valeur null et calcule automatiquement la longueur.

Valeur retournée

Retourne TRUE si la chaîne d’entrée est déjà normalisée dans le formulaire 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’est pas valide.
• ERROR_NO_UNICODE_TRANSLATION. Unicode non valide a été trouvé dans la chaîne.
• ERROR_SUCCESS. L’action s’est terminée avec succès, mais n’a produit aucun résultat.

Remarques

Windows XP, Windows Server 2003 :

Non pris en charge.

Le fichier d’en-tête et la DLL requis font partie des API d’atténuation idN (Microsoft Internationalized Domain Name), qui ne sont plus disponibles pour le téléchargement.

Examples

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

Spécifications

Voir aussi

NORM_FORM

prise en charge des langues nationales

fonctions de prise en charge des langues nationales

NormalizeString

Utilisation de la normalisation Unicode pour représenter des chaînes