Função DownlevelVerifyScripts

Compara duas listas enumeradas de scripts.

Sintaxe

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

Parâmetros

dwFlags [in]

Sinalizadores especificando opções de verificação de script.

Valor	Significado
VS_ALLOW_LATIN	Permitir "Latn" (script latino) na lista de testes, mesmo que não esteja na lista de localidades.

 

lpLocaleScripts [in]

Ponteiro para a lista de localidades, a lista enumerada de scripts para uma determinada localidade. Essa lista normalmente é preenchida chamando DownlevelGetLocaleScripts.

cchLocaleScripts [in]

Tamanho, em caracteres, da cadeia de caracteres indicada por lpLocaleScripts. O aplicativo define esse parâmetro como -1 se a cadeia de caracteres terminar em nulo. Se esse parâmetro for definido como 0, a função falhará.

lpTestScripts [in]

Ponteiro para a lista de testes, uma segunda lista enumerada de scripts. Essa lista normalmente é preenchida chamando DownlevelGetStringScripts.

cchTestScripts [in]

Tamanho, em caracteres, da cadeia de caracteres indicada por lpTestScripts. O aplicativo define esse parâmetro como -1 se a cadeia de caracteres terminar em nulo. Se esse parâmetro for definido como 0, a função falhará.

Valor retornado

Retorna TRUE se a lista de testes não estiver vazia e todos os itens na lista também estiverem incluídos na lista de localidades. Caso contrário, a função retornará FALSE.

Um valor retornado de FALSE pode indicar que a lista de testes contém um item que não está na lista de localidades ou pode indicar um erro. Para distinguir entre esses dois casos, o aplicativo pode chamar GetLastError. Se DownlevelVerifyScripts tiver determinado com êxito que há um item na lista de testes que não está na lista de localidades, GetLastError retornará ERROR_SUCCESS. Caso contrário, GetLastError poderá retornar um dos seguintes códigos de erro:

• ERROR_INVALID_FLAGS. Os valores fornecidos para os sinalizadores não eram válidos.
• ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.

Comentários

Essa função compara cadeias de caracteres, como "Latn; Cyrl;", que consiste em uma série de nomes de script de 4 caracteres, com cada nome de script seguido por um ponto e vírgula. Também há um caso especial para considerar o fato de que o script latino frequentemente é usado em idiomas e regiões em que ele não é nativo.

Essa função é útil como parte de uma estratégia para atenuar problemas de segurança relacionados a IDNs (nomes de domínio internacionalizados).

Veja a seguir exemplos do retorno dessa função e uma chamada subsequente para GetLastError em vários cenários. Os dois últimos exemplos ilustram, respectivamente, um caso em que a lista de testes não tem um ponto e vírgula de terminação (cadeia de caracteres malformada) e um caso em que a lista de testes está vazia.

O arquivo de cabeçalho necessário e a DLL fazem parte do download das "APIs de Mitigação de IDN (Nome de Domínio Internacionalizado) da Microsoft", disponíveis no archive.org.

Requisitos

Confira também

Suporte ao idioma nacional

Funções de suporte ao idioma nacional

Manipular IDNs (nomes de domínio internacionalizados)

DownlevelGetLocaleScripts

DownlevelGetStringScripts

VerifyScripts