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 |
|
| DLL |
|