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 |
|---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Ein ungültiges Argument wurde übergeben. |
|
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 |
|
| DLL |
|