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