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


Функция AllocConnections

Примечание

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

Функция AllocConnections выделяет память для указанного числа структур Connections .

Синтаксис

NAPAPI HRESULT WINAPI AllocConnections(
  _Inout_ Connections **connections,
  _In_    UINT16      connectionsCount
);

Параметры

connections [in, out]

Указатель на массив недавно выделенных структур Connections .

connectionsCount [in]

Количество структур, выделяемых для подключений.

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

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

Комментарии

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

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

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

Требования

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

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

FreeConnections