Funzione DownlevelVerifyScripts

  • Articolo

Confronta due elenchi enumerati di script.

Nota

Questa funzione viene usata solo dalle applicazioni eseguite nei sistemi operativi pre-Windows Vista. L'uso richiede il pacchetto di download. Le applicazioni eseguite solo in Windows Vista e versioni successive devono chiamare VerifyScripts.

 

Sintassi

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

Parametri

dwFlags [in]

Flag che specificano le opzioni di verifica dello script.

Valore Significato
VS_ALLOW_LATIN
 Consenti "Latn" (script latino) nell'elenco di test, anche se non si trova nell'elenco delle impostazioni locali.

 

lpLocaleScripts [in]

Puntatore all'elenco delle impostazioni locali, l'elenco enumerato di script per una determinata impostazione locale. Questo elenco viene in genere popolato chiamando DownlevelGetLocaleScripts.

cchLocaleScripts [in]

Dimensioni, in caratteri, della stringa indicata da lpLocaleScripts. L'applicazione imposta questo parametro su -1 se la stringa è con terminazione Null. Se questo parametro è impostato su 0, la funzione ha esito negativo.

lpTestScripts [in]

Puntatore all'elenco di test, un secondo elenco enumerato di script. Questo elenco viene in genere popolato chiamando DownlevelGetStringScripts.

cchTestScripts [in]

Dimensioni, in caratteri, della stringa indicata da lpTestScripts. L'applicazione imposta questo parametro su -1 se la stringa è con terminazione Null. Se questo parametro è impostato su 0, la funzione ha esito negativo.

Valore restituito

Restituisce TRUE se l'elenco di test non è vuoto e anche tutti gli elementi dell'elenco sono inclusi nell'elenco delle impostazioni locali. In caso contrario, la funzione restituisce FAL edizione Standard.

Un valore restituito di FAL edizione Standard può indicare che l'elenco di test contiene un elemento non incluso nell'elenco delle impostazioni locali oppure può indicare un errore. Per distinguere questi due casi, l'applicazione può chiamare GetLastError. Se DownlevelVerifyScripts ha determinato correttamente che è presente un elemento nell'elenco di test che non si trova nell'elenco delle impostazioni locali, GetLastError restituisce ERROR_SUCCESS. In caso contrario, GetLastError può restituire uno dei codici di errore seguenti:

  • ERROR_INVALID_FLAGS. I valori specificati per i flag non sono validi.
  • ERROR_INVALID_PARAMETER. Uno dei valori dei parametri non è valido.

Osservazioni:

Questa funzione confronta le stringhe, ad esempio "Latn; Cyrl;", costituito da una serie di nomi di script a 4 caratteri, con ogni nome di script seguito da un punto e virgola. Ha anche un caso speciale per tenere conto del fatto che lo script latino viene spesso usato nelle lingue e nelle impostazioni locali per cui non è nativo.

Questa funzione è utile come parte di una strategia per attenuare i problemi di sicurezza correlati ai nomi di dominio internazionalizzati (IDN).

Di seguito sono riportati esempi della restituzione di questa funzione e di una chiamata successiva a GetLastError in vari scenari. Gli ultimi due esempi illustrano, rispettivamente, un caso in cui l'elenco di test non dispone di un punto e virgola terminante (stringa in formato non valido) e un caso in cui l'elenco di test è vuoto.

Stringa "Locale" Stringa "Test" dwFlags Valore restituito GetLastError return
Hani; Hira; Kana; Hani; N/D TRUE N/D
Hani; Hira; Kana; Hani; Latn; 0 FALSE ERROR_SUCCESS
Hani; Hira; Kana; Hani; Latn; VS_ALLOW_LATIN TRUE N/D
Hani; Hira; Kana; Cyrl; N/D FALSE ERROR_SUCCESS
Hani; Hira; Kana; Cyrl; N/D FALSE ERROR_INVALID_PARAMETER
Hani; Hira; Kana; N/D FALSE ERROR_SUCCESS

 

Il file di intestazione e la DLL necessari fanno parte del download delle API di mitigazione IDN (Microsoft Internationalized Domain Name) disponibili da archive.org.

Requisiti

Requisito Valore
Client minimo supportato
 Windows XP [solo app desktop]
Server minimo supportato
 Windows Server 2003 [solo app desktop]
Componente ridistribuibile
 API di mitigazione IDN (Internationalized Domain Name) microsoft inWindows XP con SP2,Windows Server 2003 con SP1 oWindows Vista
Intestazione
Idndl.h
DLL
Idndl.dll

Vedi anche

Supporto per la lingua nazionale

Funzioni di supporto per il linguaggio nazionale

Gestione dei nomi di dominio internazionalizzati (IDN)

DownlevelGetLocaleScripts

DownlevelGetStringScripts

VerifyScripts