IsNormalizedString 函数 (winnls.h)

验证是否根据 Unicode 4.0 TR#15 规范化字符串。 有关详细信息,请参阅 使用 Unicode 规范化表示字符串

Syntax

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

参数

[in] NormForm

要使用的规范化形式。 NORM_FORM 指定标准 Unicode 规范化形式。

[in] lpString

指向要测试的字符串的指针。

[in] cwLength

输入字符串的长度(以字符为单位)包括 null 终止字符。 如果此值为 -1,则该函数假定字符串为 null 终止,并自动计算长度。

返回值

如果输入字符串已规范化为适当的格式,则返回 TRUE ;否则返回 FALSE 。 若要获取扩展的错误信息,应用程序可以调用 GetLastError,这会返回以下错误代码之一:

  • ERROR_INVALID_PARAMETER。 任何参数值都无效。
  • ERROR_NO_UNICODE_TRANSLATION。 在字符串中找到无效的 Unicode。
  • ERROR_SUCCESS。 作已成功完成,但未生成任何结果。
如果需要从错误条件可靠地确定 FALSE ,则必须调用 SetLastError(ERROR_SUCCESS)。

注解

Windows XP、Windows Server 2003

不再受支持。

所需的头文件和 DLL 是Microsoft国际化域名(IDN)缓解 API 的一部分,这些 API 不再可供下载。

例子

显示在 NLS:Unicode 规范化示例中找到使用此函数的示例。

要求

Requirement 价值
最低支持的客户端 Windows Vista [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2008 [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header winnls.h (包括 Windows.h)
Library kernel32。自由
DLL Normaliz.dll
可再发行组件 Microsoft国际化域名(IDN)缓解 API 上的 Windows XP SP2 及更高版本,或 Windows Server 2003 SP1

另请参阅

NORM_FORM

国家语言支持

国家语言支持函数

NormalizeString

使用 Unicode 规范化表示字符串