PFN_WSK_RELEASE_DATA_INDICATION_LIST Rückruffunktion (wsk.h)
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 |
|---|---|
|
Die Liste der Puffer wurde erfolgreich veröffentlicht. |
|
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 |