UtilLoadStringWithAlloc function

The UtilLoadStringWithAlloc function allocates and loads a string out of the resource table.

Syntax

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

Parameters

uID [in]

Type: UINT

Identifier of the string to be loaded.

ppwzBuffer [out]

Type: LPWSTR*

The ___location where the newly allocated string will be placed. The string must be freed using CoTaskMemFree when it is no longer needed.

cchBufferMax [in]

Type: UINT

The maximum number of characters to load from the resource table. If the resource string is longer than the number of characters specified, it is truncated and null-terminated.

Note

This parameter may not be set to zero.

Return value

Type: HRESULT

Possible return values include, but are not limited to, the following.

Requirements

See also

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree