Função IsNormalizedString (winnls.h)

Verifica se uma cadeia de caracteres é normalizada de acordo com o Unicode 4.0 TR#15. Para obter mais informações, consulte Como usar a normalização Unicode para representar cadeias de caracteres.

Sintaxe

BOOL IsNormalizedString(
  [in] NORM_FORM NormForm,
  [in] LPCWSTR   lpString,
  [in] int       cwLength
);

Parâmetros

[in] NormForm

Formulário de normalização a ser usado. NORM_FORM especifica os formulários de normalização Unicode padrão.

[in] lpString

Ponteiro para a cadeia de caracteres a ser testada.

[in] cwLength

Comprimento, em caracteres, da cadeia de caracteres de entrada, incluindo um caractere de encerramento nulo. Se esse valor for -1, a função assumirá que a cadeia de caracteres será encerrada em nulo e calculará o comprimento automaticamente.

Valor de retorno

Retornará TRUE se a cadeia de caracteres de entrada já estiver normalizada para o formulário apropriado ou FALSE caso contrário. Para obter informações de erro estendidas, o aplicativo pode chamar GetLastError, que pode retornar um dos seguintes códigos de erro:

• ERROR_INVALID_PARAMETER. Qualquer um dos valores de parâmetro era inválido.
• ERROR_NO_UNICODE_TRANSLATION. Unicode inválido foi encontrado na cadeia de caracteres.
• ERROR_SUCCESS. A ação foi concluída com êxito, mas não rendeu resultados.

Observações

Windows XP, Windows Server 2003:

Não há mais suporte.

O arquivo de cabeçalho necessário e a DLL fazem parte das APIs de Mitigação do IDN (Nome de Domínio Internacionalizado) da Microsoft, que não estão mais disponíveis para download.

Exemplos

Um exemplo mostrando o uso dessa função pode ser encontrado no NLS: Exemplo de Normalização Unicode.

Requirements

Consulte também

NORM_FORM

de Suporte à Linguagem Nacional

funções de suporte à linguagem nacional

NormalizeString

Usando a normalização unicode para representar cadeias de caracteres