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
 系统已用完虚拟内存。 此操作失败。

备注

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

  • 在 中 ，参数由调用方分配和释放。
  • Out 参数由被调用方分配，并由调用方使用 CoTaskMem 释放。
  • 输入/输出 参数由调用方分配，被调用方释放和重新分配，并最终由调用方使用 CoTaskMem 释放。

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

要求

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

另请参阅

FreeConnections