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 结尾。 请考虑使用以下替代方法之一。 StringCbCopyStringCbCopyExStringCbCopyNStringCbCopyNExStringCchCopyStringCchCopyExStringCchCopyNStringCchCopyNEx。 在继续之前,应查看 安全注意事项:Microsoft Windows Shell

要求

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