Функция UtilStringCopyWithAlloc

Статья
06/13/2023

Функция UtilStringCopyWithAlloc выделяет и копирует исходную строку.

Синтаксис

HRESULT UtilStringCopyWithAlloc(
  _Out_ LPWSTR  *Buffer,
  _In_  UINT    BufferMax,
  _In_  LPCWSTR Source
);

Параметры

Buffer [out]

Тип: LPWSTR*

Расположение, в котором хранится указатель на выделенную память. Если оно больше не требуется, оно должно быть выпущено вместе с CoTaskMemFree. Этот буфер всегда заканчивается значением NULL.

BufferMax [in]

Тип: UINT

Максимальное количество символов, считываемых из источника.

Источник [вход]

Тип: LPCWSTR

Строка для копирования.

Возвращаемое значение

Тип: HRESULT

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата	Описание
S_OK	Операция успешно выполнена.
E_INVALIDARG	Один или несколько параметров указаны неправильно.

Требования

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

См. также раздел

CoTaskMemFree
UtilAssembleStringsWithAlloc
UtilLoadStringWithAlloc

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