SHLocalStrDupA 函数（shlwapi.h）

在新分配的内存中复制字符串。

语法

HRESULT SHLocalStrDupA(
                  PCSTR psz,
  [out, optional] PSTR  *ppsz
);

psz

类型：PCTSTR

指向要复制的以 null 结尾的 Unicode 字符串的指针。

[out, optional] ppsz

类型：PTSTR*

指向已分配字符串的指针的地址，当此函数成功返回时，将接收结果。 SHLocalStrDup 为此字符串分配内存，LocalAlloc。当不再需要该字符串时，应释放具有 LocalFree 的字符串。

类型：HRESULT

如果此函数成功，则返回 S_OK。否则，它将返回 HRESULT 错误代码。

注意

shlwapi.h 标头将 SHLocalStrDup 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。