Funzione DownlevelGetStringScripts

Articolo
12/21/2023

Fornisce un elenco di script utilizzati nella stringa Unicode specificata.

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 GetStringScripts.

Sintassi

int DownlevelGetStringScripts(
  _In_  DWORD   dwFlags,
  _In_  LPCWSTR lpString,
  _In_  int     cchString,
  _Out_ LPWSTR  lpScripts,
  _In_  int     cchScripts
);

Parametri

dwFlags [in]

Flag che specificano le opzioni per il recupero di script.

Valore	Significato
GSS_ALLOW_INHERITED_COMMON	Recuperare le informazioni sullo script "Qaii" (INHERITED) e "Zyyy" (COMMON). Questo valore non influisce sull'elaborazione di caratteri non assegnati. Questi caratteri nella stringa di input causano sempre la visualizzazione di un "Zzzz" (script UNASSIGNED) nella stringa di script.

Nota

Per impostazione predefinita, questa funzione ignora tutti i caratteri ereditati o comuni nella stringa Unicode di input. Se GSS_ALLOW_INHERITED_COMMON non è impostato, né "Qaii" né "Zyyy" verranno visualizzati nella stringa di script, anche se la stringa di input contiene tali caratteri. Se GSS_ALLOW_INHERITED_COMMON è impostato e se la stringa di input contiene caratteri ereditati e/o comuni, nella stringa di script viene visualizzato "Qaii" e/o "Zyyy". Vedere la sezione relativa alle osservazioni.

lpString [in]

Puntatore alla stringa Unicode da analizzare.

cchString [in]

Dimensioni, in caratteri, della stringa Unicode indicata da lpString. L'applicazione imposta questo parametro su -1 se la stringa è con terminazione Null. Se l'applicazione imposta questo parametro su 0, la funzione recupera una stringa Unicode null (L"\0") in lpScripts e restituisce 1.

lpScripts [out]

Puntatore a un buffer in cui questa funzione recupera una stringa con terminazione Null che rappresenta un elenco di script, usando la notazione a 4 caratteri usata in ISO 15924. Ogni nome di script è costituito da quattro caratteri latini e i nomi vengono recuperati in ordine alfabetico. Ogni nome, incluso l'ultimo, è seguito da un punto e virgola.

In alternativa, questo parametro può contenere NULL se cchScripts è impostato su 0. In questo caso, la funzione restituisce le dimensioni necessarie per il buffer di script.

cchScripts [in]

Dimensioni, in caratteri, per il buffer di script indicato da lpScripts.

In alternativa, l'applicazione può impostare questo parametro su 0. In questo caso, la funzione recupera NULL in lpScripts e restituisce le dimensioni necessarie per il buffer di script.

Valore restituito

Restituisce il numero di caratteri recuperati nel buffer di output, incluso un carattere Null di terminazione, se ha esito positivo e cchScripts è impostato su un valore diverso da zero. La funzione restituisce 1 per indicare che non è stato trovato alcuno script, ad esempio quando la stringa di input contiene solo caratteri COMMON o INHERITED e GSS_ALLOW_INHERITED_COMMON non è impostata. Dato che ogni script trovato aggiunge cinque caratteri (quattro caratteri + delimitatore), una semplice operazione matematica fornisce il numero di script come (return_code - 1) / 5.

Se la funzione ha esito positivo e il valore di cchScripts è 0, il valore restituito è la dimensione necessaria, in caratteri che includono un carattere Null di terminazione, per il buffer di script. Il conteggio degli script è come descritto in precedenza.

La funzione restituisce 0 se non riesce. Per ottenere informazioni di errore estese, l'applicazione può chiamare GetLastError, che può restituire uno dei codici di errore seguenti:

ERROR_BADDB. La funzione non è riuscita ad accedere ai dati. Questa situazione non dovrebbe verificarsi normalmente e in genere indica un'installazione non valida, un problema del disco o simili.
ERROR_INSUFFICIENT_BUFFER. Le dimensioni del buffer fornite non sono sufficienti o non sono state impostate correttamente su NULL.
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 è utile come parte di una strategia per attenuare i problemi di sicurezza correlati ai nomi di dominio internazionalizzati (IDN).

La determinazione dello script è basata sui valori di script pubblicati dal Consorzio Unicode in https://www.unicode.org/Public/4.1.0/ucd/Scripts.txt, ad eccezione del fatto che i caratteri non assegnati hanno il valore "Zzzz" (UNASSIGNED) anziché "Zyyy" (COMMON).

Ecco alcuni esempi del comportamento di questa funzione:

Stringa di input

dwFlags

lpScripts

Scripts

Microsoft.com

Latn;

Latino

Microsoft.com

GSS_ALLOW_INHERITED_COMMON

Latn; Zyyy;

Latino + Comune

${ROWSPAN2}$Ni ño${REMOVE}$

004E 0069 0241 006F

${ROWSPAN2}$GSS_ALLOW_INHERITED_COMMON${REMOVE}$

${ROWSPAN2}$Latn;${REMOVE}$

${ROWSPAN2}$Latin${REMOVE}$

Usa LETTERE MINUSCOLE LATINE N CON TILDE

${ROWSPAN2}$Ni ño${REMOVE}$

004E 0069 006E 0303 006F

${ROWSPAN2}$GSS_ALLOW_INHERITED_COMMON${REMOVE}$

${ROWSPAN2}$Latn; Qaii;${REMOVE}$

${ROWSPAN2}$Latin + Ereditato${REMOVE}$

Usa LA COMBINAZIONE DI TILDE

${ROWSPAN2}$Sp ооf${REMOVE}$

0053 0070 043e 043e 0066

${ROWSPAN2}$0${REMOVE}$

${ROWSPAN2}$Latn; Cyrl;${REMOVE}$

${ROWSPAN2}$Latin + cirillico${REMOVE}$

Utilizza LETTERE MINUSCOLE CIRILLICO O



U+f000

Zzzz;

Non assegnate

