Функция AllocCountedString

Примечание

Платформа защиты доступа к сети недоступна, начиная с Windows 10

Функция AllocCountedString выделяет память для строки, завершающейся null, и возвращает ее в структуре CountedString .

Синтаксис

NAPAPI HRESULT WINAPI AllocCountedString(
  _Inout_       CountedString **countedString,
  _In_    const WCHAR         *string
);

Параметры

countedString [in, out]

Указатель на адрес только что выделенной структуры CountedString .

string [in]

Указатель на строку, завершающуюся значением NULL, которая возвращается в countedString.

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

Код возврата Описание
S_OK
Операция успешно завершена.
E_INVALIDARG
Передан недопустимый аргумент.
E_OUTOFMEMORY
Система выходит за пределы виртуальной памяти. Эта операция завершилась сбоем.

Remarks

Все com-интерфейсы, поддерживаемые системой NAP, используют стандартные правила управления памятью COM и распределители памяти COM (CoTaskMemAlloc и CoTaskMemFree):

  • В параметрах выделяется и освобождается вызывающим объектом.
  • Параметры out выделяются вызывающим объектом и освобождаются вызывающим объектом с помощью CoTaskMem.
  • Параметры входа и выхода выделяются вызывающим объектом, освобождаются и перераспределяются вызывающим объектом и в конечном итоге освобождаются вызывающим объектом с помощью CoTaskMem.

Все функции NAP для освобождения памяти также освобождают все внедренные указатели.

Требования

Требование Значение
Минимальная версия клиента
Windows Vista [только классические приложения]
Минимальная версия сервера
Windows Server 2008 [только классические приложения]
Заголовок
NapUtil.h
DLL
Qutil.dll

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

FreeCountedString