Функция 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	Один или несколько параметров не предоставлены правильно.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows 8 [только настольные приложения]
Минимальный поддерживаемый сервер	Windows Server 2012 [только настольные приложения]
Заголовок	Ndattributils.h

См. также

UtilStringCopyWithAlloc

UtilAssembleStringsWithAlloc

CoTaskMemFree