Функция UtilLoadStringWithAlloc

Статья
06/13/2023

Функция 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

Поделиться через