Поделиться через

Функция 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. Действие выполнено успешно, но не дало результатов.
Если необходимо надежно определить false из условия ошибки, необходимо вызвать SetLastError(ERROR_SUCCESS).

Замечания

Windows XP, Windows Server 2003:

Больше не поддерживается.

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

Примеры

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

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows Vista [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер Windows Server 2008 [классические приложения | Приложения UWP]
целевая платформа Виндоус
Header winnls.h (включая Windows.h)
Library kernel32. Lib
DLL Normaliz.dll
Распространяемый API устранения рисков microsoft Internationalized Domain Name (IDN) onWindows XP с пакетом обновления 2 (SP2) илиWindows Server 2003 с пакетом обновления 1 (SP1)

См. также

NORM_FORM

поддержки национальных языков

функции поддержки национальных языков

НормализацияString

Использование нормализации Юникода для представления строк

  • Last updated on