IsNormalizedString 函数 (winnls.h)

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

语法

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 的一部分,不再可供下载。

示例

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

要求

   
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 winnls.h (包括 Windows.h)
DLL Normaliz.dll
可再发行组件 Microsoft 国际化域名 (IDN) 带 SP2 及更高版本 Windows XP 或 Windows Server 2003 SP1 的缓解 API

另请参阅

NORM_FORM

国家语言支持

国家语言支持函数

NormalizeString

使用 Unicode 规范化来表示字符串