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

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

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