PFN_WSK_RELEASE_DATA_INDICATION_LIST Rückruffunktion (wsk.h)

Artikel
02/27/2024

Die WskRelease-Funktion gibt eine verknüpfte Liste von WSK_DATA_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 verbindungsorientierte oder lauschende Sockets beschrieben. Informationen zu Datagram-Sockets finden Sie unter WskRelease (Datagram-Sockets).

Syntax

PFN_WSK_RELEASE_DATA_INDICATION_LIST PfnWskReleaseDataIndicationList;

NTSTATUS PfnWskReleaseDataIndicationList(
  [in] PWSK_SOCKET Socket,
  [in] PWSK_DATA_INDICATION DataIndication
)
{...}

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] DataIndication

Ein Zeiger auf die verknüpfte Liste der zu veröffentlichenden Strukturen. Für diesen Parameter sollte die WSK-Anwendung den DataIndication-Parameter angeben, der an die WskReceiveEvent - oder WskReceiveFromEvent-Ereignisrückruffunktion übergeben wurde.

Rückgabewert

WskRelease gibt einen der folgenden NTSTATUS-Codes zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Die Liste der Puffer wurde erfolgreich veröffentlicht.
STATUS_INVALID_PARAMETER	Ein ungültiger Parameter wurde angegeben.

Hinweise

Für verbindungsorientierte oder lauschende Sockets ruft eine WSK-Anwendung die WskRelease-Funktion auf, um eine verknüpfte Liste von WSK_DATA_INDICATION Strukturen freizugeben, die sie zuvor beibehalten hat, indem sie STATUS_PENDING entweder von seinem WskReceiveEvent oder seiner WskReceiveFromEvent-Ereignisrückruffunktion zurückgibt.

Das Schließen eines Sockets durch Aufrufen der WskCloseSocket-Funktion gibt keine ausstehenden beibehaltenen verknüpften Listen von Strukturen frei. 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