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 或更高版本)