AllocConnections-Funktion

Artikel
06/13/2023

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die AllocConnections-Funktion weist Arbeitsspeicher für eine angegebene Anzahl von Verbindungsstrukturen zu.

Syntax

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

Parameter

Verbindungen [ein, ausgehend]: Ein Zeiger auf ein Array neu zugeordneter Verbindungsstrukturen .
connectionsCount [in]: Die Anzahl der Strukturen, die Verbindungen zugeordnet werden sollen.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG	Ein ungültiges Argument wurde übergeben.
E_OUTOFMEMORY	Das System verfügt nicht über den virtuellen Arbeitsspeicher. Bei diesem Vorgang ist ein Fehler aufgetreten.

Bemerkungen

Alle vom NAP-System unterstützten COM-Schnittstellen verwenden standardmäßige COM-Speicherverwaltungsregeln und die COM-Speicherzuweisungen (CoTaskMemAlloc und CoTaskMemFree):

Parameter in werden vom Aufrufer zugeordnet und freigegeben.
Out-Parameter werden vom Aufgerufenen zugeordnet und vom Aufrufer mithilfe von CoTaskMem freigegeben.
In/out-Parameter werden vom Aufrufer zugeordnet, vom Aufgerufenen freigegeben und neu zugeordnet und schließlich vom Aufrufer mithilfe von CoTaskMem freigegeben.

Alle NAP-Funktionen zum Freigeben von Arbeitsspeicher geben auch alle eingebetteten Zeiger frei.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	NapUtil.h
DLL	Qutil.dll

Siehe auch

FreeConnections

Freigeben über