StrCpyNW 函数 (shlwapi.h)
将指定数量的字符从一个字符串的开头复制到另一个字符串。
注意 请勿使用此函数或 StrNCpy 宏。 有关备用函数,请参阅备注。
语法
PWSTR StrCpyNW(
[out] PWSTR pszDst,
[in] PCWSTR pszSrc,
int cchMax
);
参数
[out] pszDst
类型: PTSTR
指向缓冲区的指针,当此函数成功返回时,该缓冲区接收复制的字符串。 此缓冲区的大小必须足以容纳复制的字符。 不保证此字符串以 null 结尾。
[in] pszSrc
类型: PCTSTR
指向以 null 结尾的源字符串的指针。
cchMax
类型: int
要复制的字符数,包括终止 null 字符。
返回值
类型: PTSTR
返回指向 pszDst 的指针。
注解
安全警告: 错误使用此函数可能会危及应用程序的安全性。 复制的字符串不保证以 null 结尾。 请考虑使用以下替代方法之一。 StringCbCopy、 StringCbCopyEx、 StringCbCopyN、 StringCbCopyNEx、 StringCchCopy、 StringCchCopyEx、 StringCchCopyN、 StringCchCopyNEx。 在继续之前,应查看 安全注意事项:Microsoft Windows Shell 。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shlwapi.h |
Library | Shlwapi.lib |
DLL | Shlwapi.dll (版本 4.71 或更高版本) |