UtilLoadStringWithAlloc 函数

UtilLoadStringWithAlloc 函数分配并加载资源表中的字符串。

语法

HRESULT UtilLoadStringWithAlloc(
  _In_  UINT   uID,
  _Out_ LPWSTR *ppwzBuffer,
  _In_  UINT   cchBufferMax
);

uID [in]

类型：UINT

要加载的字符串的标识符。

ppwzBuffer [out]

类型：LPWSTR*

将放置新分配的字符串的位置。不再需要该字符串时，必须使用 CoTaskMemFree 释放该字符串。

cchBufferMax [in]

类型：UINT

要从资源表加载的最大字符数。如果资源字符串的长度超过指定的字符数，则会截断并终止 null。

注释

此参数可能未设置为零。

类型：HRESULT

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

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