PFN_WSK_RELEASE_DATAGRAM_INDICATION_LIST Rückruffunktion (wsk.h)

Artikel
02/27/2024

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
STATUS_SUCCESS	Die Liste der Strukturen wurde erfolgreich freigegeben.
STATUS_INVALID_PARAMETER	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