Функция IsNormalizedString (winnls.h)

Статья
08/27/2023

Проверяет, нормализована ли строка в соответствии с Юникодом 4.0 TR#15. Дополнительные сведения см. в разделе Использование нормализации Юникода для представления строк.

Синтаксис

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

Параметры

[in] NormForm

Используемая форма нормализации. NORM_FORM задает стандартные формы нормализации Юникода.

[in] lpString

Указатель на проверяемую строку.

[in] cwLength

Длина входной строки в символах, включая завершающий символ NULL. Если это значение равно -1, функция предполагает, что строка заканчивается null и автоматически вычисляет длину.

Возвращаемое значение

Возвращает значение TRUE , если входная строка уже нормализована до соответствующей формы, или false в противном случае. Чтобы получить расширенные сведения об ошибке, приложение может вызвать Метод GetLastError, который может возвращать один из следующих кодов ошибок:

ERROR_INVALID_PARAMETER. Любое из значений параметров было недопустимым.
ERROR_NO_UNICODE_TRANSLATION. В строке обнаружен недопустимый Юникод.
ERROR_SUCCESS. Действие выполнено успешно, но не дало результатов.

Если необходимо надежно определить значение FALSE на основе ошибки, необходимо вызвать SetLastError(ERROR_SUCCESS).

Необходимый файл заголовка и библиотека DLL являются частью API-интерфейсов устранения международных доменных имен (IDN) Майкрософт, которые больше не доступны для скачивания.

Примеры

Пример использования этой функции можно найти в NLS: пример нормализации Юникода.

Требования


Минимальная версия клиента	Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winnls.h (включая Windows.h)
DLL	Normaliz.dll
Распространяемые компоненты	API-интерфейсы устранения международных доменных имен (IDN) в Windows XP с пакетом обновления 2 (SP2) или Windows Server 2003 с пакетом обновления 1 (SP1)