idnToNameprepUnicode 函数 (winnls.h)

项目
08/27/2023

将国际化域名 (IDN) 或其他国际化标签转换为网络工作组 RFC 3491 指定的 NamePrep 表单，但不执行到 Punycode 的其他转换。有关相关标准草案的详细信息和链接，请参阅处理国际化域名 (IDN) 。

语法

int IdnToNameprepUnicode(
  [in]            DWORD   dwFlags,
  [in]            LPCWSTR lpUnicodeCharStr,
  [in]            int     cchUnicodeChar,
  [out, optional] LPWSTR  lpNameprepCharStr,
  [in]            int     cchNameprepChar
);

参数

[in] dwFlags

指定转换选项的标志。有关详细定义，请参阅 IdnToAscii 的 dwFlags 参数。

[in] lpUnicodeCharStr

指向表示 IDN 或其他国际化标签的 Unicode 字符串的指针。

[in] cchUnicodeChar

lpUnicodeCharStr 指示的输入 Unicode 字符串中的 Unicode 字符计数。

[out, optional] lpNameprepCharStr

指向缓冲区的指针，该缓冲区接收通过 NamePrep 处理转换的输入 Unicode 字符串的版本。或者，如果 cchNameprepChar 设置为 0，则函数可以检索此参数的 NULL。在这种情况下，函数返回此缓冲区所需的大小。

[in] cchNameprepChar

lpNameprepCharStr 指示的缓冲区的大小（以字符为单位）。应用程序可以将大小设置为 0 以在 lpNameprepCharStr 中检索 NULL，并让函数返回所需的缓冲区大小。

返回值

如果成功，则返回 在 lpNameprepCharStr 中 检索到的字符数。仅当输入 Unicode 字符串以 null 结尾时，检索到的字符串才以 null 结尾。

如果函数成功且 cchNameprepChar 的值为 0，则该函数将返回所需大小（以字符为单位），包括终止 null 字符（如果它是输入缓冲区的一部分）。

如果函数不成功，则返回 0。若要获取扩展的错误信息，应用程序可以调用 GetLastError，这会返回以下错误代码之一：

ERROR_INSUFFICIENT_BUFFER。提供的缓冲区大小不够大，或者错误地设置为 NULL。
ERROR_INVALID_FLAGS。为标志提供的值无效。
ERROR_INVALID_NAME。向函数提供的名称无效。请注意，此错误代码捕获所有语法错误。
ERROR_INVALID_PARAMETER。任何参数值都无效。
ERROR_NO_UNICODE_TRANSLATION。在字符串中发现无效的 Unicode。

注解

请参阅 IdnToAscii 的备注。

示例

NLS：国际化域名 (IDN) 转换示例演示了此函数的用法。

要求


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