PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST Rückruffunktion (wsk.h)
Die WskRelease-Funktion gibt eine verknüpfte Liste von WSK_DATAGRAM_INDICATION Strukturen frei, die zuvor von einer WSK-Anwendung beibehalten wurden.
WskRelease kann je nach Sockettyp auf zwei verschiedene Arten deklariert werden. In diesem Thema wird WskRelease für Datagrammsockets beschrieben. Informationen zu verbindungsorientierten oder lauschenden Sockets finden Sie unter WskRelease (verbindungsorientierte oder lauschende Sockets).
Syntax
PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST PfnWskReleaseDatagramIndicationList;
NTSTATUS PfnWskReleaseDatagramIndicationList(
[in] PWSK_SOCKET Socket,
[in] PWSK_DATAGRAM_INDICATION DatagramIndication
)
{...}
Parameter
[in] Socket
Ein Zeiger auf eine WSK_SOCKET-Struktur , die das Socketobjekt für den Socket angibt, von dem die Daten empfangen wurden.
[in] DatagramIndication
Ein Zeiger auf die verknüpfte Liste der zu veröffentlichenden Strukturen. Für diesen Parameter sollte die WSK-Anwendung den DatagramIndication-Parameter angeben, der an die Ereignisrückruffunktion WskReceiveEvent oder WskReceiveFromEvent übergeben wurde.
Rückgabewert
WskRelease gibt einen der folgenden NTSTATUS-Codes zurück:
| Rückgabecode | Beschreibung |
|---|---|
|
Die Liste der Strukturen wurde erfolgreich freigegeben. |
|
Ein ungültiger Parameter wurde angegeben. |
Hinweise
Eine WSK-Anwendung ruft die WskRelease-Funktion auf, um eine verknüpfte Liste von WSK_DATAGRAM_INDICATION Strukturen freizugeben, die sie zuvor beibehalten hat, indem sie STATUS_PENDING entweder von der WskReceiveEvent - oder der WskReceiveFromEvent-Ereignisrückruffunktion zurückgibt.
Durch das Schließen eines Sockets durch Aufrufen der WskCloseSocket-Funktion werden keine ausstehenden beibehaltenen verknüpften Listen von Strukturen freigegeben. Eine WSK-Anwendung muss alle beibehaltenen verknüpften Listen von Strukturen freigeben, bevor die Anwendung die WskCloseSocket-Funktion aufruft , um den Socket zu schließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Universell |
| Header | wsk.h (einschließen von Wsk.h) |
| IRQL | <= DISPATCH_LEVEL |