Funzione DownlevelVerifyScripts
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 |
|
| DLL |
|
Vedi anche