Função IsNormalizedString (winnls.h)

Artigo
08/27/2023

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