SHUnicodeToAnsi 函数 (shlwapi.h)

项目
08/26/2023

[此函数可通过 Windows XP 和 Windows Server 2003 使用。在后续版本的 Windows 中，它可能已更改或不可用。]

将字符串从 Unicode 代码页转换为 ANSI 代码页。

语法

int SHUnicodeToAnsi(
  [in]  PCWSTR pwszSrc,
  [out] PSTR   pszDst,
        int    cchBuf
);

参数

[in] pwszSrc

类型： PCWSTR

指向要转换为 ANSI 的以 null 结尾的 Unicode 字符串的指针。

[out] pszDst

类型： PSTR

指向缓冲区的指针，当此函数成功返回时，该缓冲区接收转换后的字符。缓冲区必须足够大，才能包含 cchBuf 参数指定的 CHAR 字符数，包括终止 null 字符的空间。

cchBuf

类型： int

pszDst 指向的缓冲区可以包含的 CHAR 值的数目。分配给参数的值必须大于零。

返回值

类型： int

返回写入输出缓冲区的 CHAR 值的数目，包括终止 null 字符。如果失败，则返回 0。

注解

安全警告： 错误使用此函数可能会危及应用程序的安全性。例如，如果 pszDst 缓冲区的大小不足以包含 cchBuf 指定的字符数，则可能发生缓冲区溢出。如果发生访问冲突，缓冲区溢出可能会导致对应用程序的拒绝服务攻击。在最坏的情况下，缓冲区溢出可能允许攻击者将可执行代码注入进程，尤其是在 pszDst 是基于堆栈的缓冲区时。此外，如果输出字符串对于缓冲区太大，则会以无提示方式截断。这可能会导致规范化或其他安全漏洞。

如果 pszDst 缓冲区的大小不足以包含整个转换后的输出字符串，则字符串将被截断以适应缓冲区。无法检测返回字符串已被截断。字符串将始终以 null 结尾，即使它已被截断。此函数注意不要截断 DBCS 字符对的前导字节和尾随字节。在这种情况下，仅返回 cchBuf-1 字符。

如果 pwszSrc 和 pszDst 缓冲区重叠，则函数的行为未定义。

注意不要假定函数未更改输出缓冲区中字符串的终止 null 字符后的任何字符。字符串终止 null 字符之后的输出缓冲区的内容未定义，最多包括缓冲区中的最后一个字符。

SHTCharToAnsi 定义为与 SHUnicodeToAnsi 相同。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server、Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
DLL	Shlwapi.dll (5.0 或更高版本)