AllocConnections 函数

注意

从Windows 10开始,网络访问保护平台不可用

AllocConnections 函数为指定数量的 Connections 结构分配内存。

语法

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

参数

连接 [in, out]

指向新分配 的连接 结构的数组的指针。

connectionsCount [in]

要分配给 连接的结构数。

返回值

返回代码 说明
S_OK
操作已成功完成。
E_INVALIDARG
传递的自变量无效。
E_OUTOFMEMORY
系统内存不足。 此操作失败。

注解

NAP 系统支持的所有 COM 接口都使用标准 COM 内存管理规则和 COM 内存分配器 (CoTaskMemAllocCoTaskMemFree) :

  • 在参数中 由调用方分配和释放。
  • Out 参数由被调用方分配,并由调用方使用 CoTaskMem 释放。
  • In/out 参数由调用方分配,由被调用方释放和重新分配,最终由调用方使用 CoTaskMem 释放。

用于释放内存的所有 NAP 函数也释放所有嵌入指针。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
NapUtil.h
DLL
Qutil.dll

另请参阅

FreeConnections