AllocConnections-Funktion

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab dem Windows 10

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

Syntax

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

Parameter

Verbindungen [ in, out]

Ein Zeiger auf ein Array neu zugeordneter Connections-Strukturen.

connectionsCount [ In]

Die Anzahl der Strukturen, die Verbindungen zuteilen werden.

Rückgabewert

Rückgabecode Beschreibung
S _ OK
Der Vorgang wurde erfolgreich abgeschlossen.
E _ INVALIDARG
Ein ungültiges Argument wurde übergeben.
E _ OUTOFMEMORY
Das System befindet sich nicht im virtuellen Arbeitsspeicher. Fehler bei diesem Vorgang.

Hinweise

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

  • In werden Parameter vom Aufrufer zugeordnet und frei.
  • Out-Parameter werden vom Aufrufer zugeordnet und vom Aufrufer mithilfe von CoTaskMem frei.
  • Ein-/Aus-Parameter werden vom Aufrufer zugeordnet, vom Aufrufer frei und neu zugeordnet und schließlich vom Aufrufer mithilfe von CoTaskMem frei.

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

Anforderungen

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

Siehe auch

FreeConnections