Функция IsNormalizedString (winnls.h)
Проверяет, нормализована ли строка в соответствии с Юникодом 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. Действие выполнено успешно, но не дало результатов.
Комментарии
Windows XP, Windows Server 2003:
Больше не поддерживается.
Необходимый файл заголовка и библиотека 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) |