Compartilhar via


Função IsNormalizedString (winnls.h)

Verifica se uma cadeia de caracteres é normalizada de acordo com Unicode 4.0 TR#15. Para obter mais informações, consulte Usando 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 terminação nulo. Se esse valor for -1, a função pressupõe que a cadeia de caracteres seja terminada em nulo e calculará o comprimento automaticamente.

Valor retornado

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.
Se você precisar determinar FALSE de forma confiável de uma condição de erro, ele deverá chamar SetLastError(ERROR_SUCCESS).

Comentários

Windows XP, Windows Server 2003:

Não tem mais suporte.

O arquivo de cabeçalho e a DLL necessários fazem parte das APIs de Mitigação de 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.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho winnls.h (inclua Windows.h)
DLL Normaliz.dll
Redistribuível APIs de mitigação do IDN (Nome de Domínio Internacionalizado) da Microsoft noWindows XP com SP2 e posterior, ouWindows Server 2003 com SP1

Confira também

NORM_FORM

Suporte à linguagem nacional

Funções de suporte à linguagem nacional

NormalizeString

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