UtilStringCopyWithAlloc 函数

UtilStringCopyWithAlloc 函数分配和复制源字符串。

语法

HRESULT UtilStringCopyWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR Source
);

参数

Buffer [out]

类型: LPWSTR*

指向已分配内存的指针的存储位置。 当不再需要时,必须使用 CoTaskMemFree 发布它。 此缓冲区始终以 null 结尾。

BufferMax [in]

类型: UINT

要从 读取的最大字符数。

[in]

类型: LPCWSTR

要复制的字符串。

返回值

类型: HRESULT

可能的返回值包括但不限于以下内容。

返回代码 说明
S_OK
操作成功。
E_INVALIDARG
未正确提供一个或多个参数。

要求

要求
最低受支持的客户端
Windows 8 [仅限桌面应用]
最低受支持的服务器
Windows Server 2012 [仅限桌面应用]
标头
Ndattributils.h

另请参阅

CoTaskMemFree

UtilAssembleStringsWithAlloc

UtilLoadStringWithAlloc