AllocConnections 函式

發行項
06/13/2023

注意

從 Windows 10 開始，無法使用網路存取保護平臺

AllocConnections 函式會為指定的連線結構數目配置記憶體。

語法

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

參數

連線 [in， out]: 新配置的 Connections 結構的陣列指標。
connectionsCount [in]: 要配置給連接的結構數目。

傳回值

傳回碼	描述
S_OK	作業已順利完成。
E_INVALIDARG	傳遞了無效的引數。
E_OUTOFMEMORY	系統已不足虛擬記憶體。此作業失敗。

備註

NAP 系統支援的所有 COM 介面都會使用標準 COM 記憶體管理規則和 COM 記憶體配置器， (CoTaskMemAlloc 和 CoTaskMemFree) ：

在參數中是由呼叫端配置和釋放。
Out 參數是由被呼叫者配置，並使用 CoTaskMem由呼叫端釋出。
In/out 參數是由呼叫端所配置、被呼叫者釋出並重新配置，最後由呼叫端使用 CoTaskMem釋出。

所有用於釋放記憶體的 NAP 函式也會釋放所有內嵌指標。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	NapUtil.h
DLL	Qutil.dll

另請參閱

FreeConnections