PFN_WSK_RELEASE_DATA_INDICATION_LIST Rückruffunktion (wsk.h)

2025-02-07

Die WskRelease Funktion gibt eine verknüpfte Liste von WSK_DATA_INDICATION Strukturen frei, die zuvor von einer WSK-Anwendung aufbewahrt wurden.

WskRelease kann je nach Sockettyp auf zwei verschiedene Arten deklariert werden. In diesem Thema werden WskRelease- für verbindungsorientierte oder überwachungsorientierte Sockets beschrieben. Informationen zu Datagrammsockets finden Sie unter WskRelease (Datagrammsockets).

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 parameter DataIndication 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 freigegeben.
STATUS_INVALID_PARAMETER	Es wurde ein ungültiger Parameter angegeben.

Bemerkungen

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

Durch Das Schließen eines Sockets durch Aufrufen der WskCloseSocket--Funktion werden keine offenen, verknüpften Listen mit 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
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Universal
Header-	wsk.h (include Wsk.h)
IRQL-	<= DISPATCH_LEVEL