DownlevelVerifyScripts fonction)

Compare deux listes énumérées de scripts.

Notes

cette fonction est utilisée uniquement par les applications qui s’exécutent sur des systèmes d’exploitation antérieurs à Windows Vista. Son utilisation requiert le package de téléchargement. les Applications qui s’exécutent uniquement sur Windows Vista et versions ultérieures doivent appeler VerifyScripts.

Syntaxe

BOOL DownlevelVerifyScripts(
  _In_ DWORD   dwFlags,
  _In_ LPCWSTR lpLocaleScripts,
  _In_ int     cchLocaleScripts,
  _In_ LPCWSTR lpTestScripts,
  _In_ int     cchTestScripts
);

Paramètres

dwFlags [ dans]

Indicateurs spécifiant les options de vérification de script.

Valeur Signification
VS _ _ latin
Autorisez « LATN » (script latin) dans la liste de tests, même s’il ne figure pas dans la liste des paramètres régionaux.

lpLocaleScripts [ dans]

Pointeur vers la liste des paramètres régionaux, liste énumérée des scripts pour des paramètres régionaux donnés. Cette liste est généralement remplie en appelant DownlevelGetLocaleScripts.

cchLocaleScripts [ dans]

Taille, en caractères, de la chaîne indiquée par lpLocaleScripts. L’application affecte à ce paramètre la valeur-1 si la chaîne se termine par un caractère null. Si ce paramètre a la valeur 0, la fonction échoue.

lpTestScripts [ dans]

Pointeur vers la liste de tests, une deuxième liste énumérée de scripts. Cette liste est généralement remplie en appelant DownlevelGetStringScripts.

cchTestScripts [ dans]

Taille, en caractères, de la chaîne indiquée par lpTestScripts. L’application affecte à ce paramètre la valeur-1 si la chaîne se termine par un caractère null. Si ce paramètre a la valeur 0, la fonction échoue.

Valeur retournée

Retourne la valeur true si la liste de tests n’est pas vide et si tous les éléments de la liste sont également inclus dans la liste des paramètres régionaux. Dans le cas contraire, la fonction retourne false.

Une valeur de retour false peut indiquer que la liste de tests contient un élément qui n’est pas dans la liste des paramètres régionaux ou qu’elle peut indiquer une erreur. Pour faire la distinction entre ces deux cas, l’application peut appeler GetLastError. Si DownlevelVerifyScripts a déterminé qu’il existe un élément dans la liste de tests qui ne figure pas dans la liste des paramètres régionaux, GetLastError retourne la réussite de l’erreur _ . Dans le cas contraire, GetLastError peut retourner l’un des codes d’erreur suivants :

  • ERREUR _ : indicateurs non valides _ . Les valeurs fournies pour les indicateurs ne sont pas valides.
  • ERREUR _ _ : paramètre non valide. Les valeurs de paramètre ne sont pas valides.

Remarques

Cette fonction compare des chaînes, telles que « Latn ». Cyrl ;», qui se compose d’une série de noms de script de 4 caractères, chaque nom de script suivi d’un point-virgule. Il a également un cas particulier de tenir compte du fait que le script latin est souvent utilisé dans les langages et les paramètres régionaux pour lesquels il n’est pas natif.

Cette fonction est utile dans le cadre d’une stratégie visant à atténuer les problèmes de sécurité liés aux noms de domaine internationaux (IDNs).

Voici des exemples de retour de cette fonction et d’un appel ultérieur à GetLastError dans différents scénarios. Les deux derniers exemples illustrent, respectivement, un cas dans lequel la liste de tests n’a pas de point-virgule de fin (chaîne incorrecte) et un cas dans lequel la liste de tests est vide.

Chaîne « locale » Chaîne « test » dwFlags Valeur retournée Retour de GetLastError
Hani; Hira; Caractères Kana Hani; N/A TRUE N/A
Hani; Hira; Caractères Kana Hani; LATN 0 FALSE ERREUR de _ réussite
Hani; Hira; Caractères Kana Hani; LATN VS _ _ latin TRUE N/A
Hani; Hira; Caractères Kana Cyrl N/A FALSE ERREUR de _ réussite
Hani; Hira; Caractères Kana Cyrl N/A FALSE paramètre d’erreur _ non valide _
Hani; Hira; Caractères Kana N/A FALSE ERREUR de _ réussite

Le fichier d’en-tête et la DLL requis font partie du téléchargement des API d’atténuation de l' IDN (Internationalized Domain Name) de Microsoft , disponible dans le Centre de téléchargement MSDN.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 2003 [ applications de bureau uniquement]
Composant redistribuable
api d’atténuation des IDN (internationalized domain Name) Microsoft onWindows XP avec SP2, Windows Server 2003 avec SP1, intégral Vista
En-tête
Idndl. h
DLL
Idndl.dll

Voir aussi

Prise en charge des langues nationales

Fonctions de prise en charge linguistique nationale

Gestion des noms de domaine internationaux (IDNs)

DownlevelGetLocaleScripts

DownlevelGetStringScripts

VerifyScripts