PFN_WSK_ABORT_EVENT Rückruffunktion (wsk.h)

Artikel
02/07/2025

Die WskAbortEvent Ereignisrückruffunktion benachrichtigt eine WSK-Anwendung, dass eine eingehende Verbindungsanforderung für einen Überwachungssocket mit aktiviertem Modus für bedingte Annahmen gelöscht wurde.

Syntax

PFN_WSK_ABORT_EVENT PfnWskAbortEvent;

NTSTATUS PfnWskAbortEvent(
  [in, optional] PVOID SocketContext,
  [in]           PWSK_INSPECT_ID InspectID
)
{...}

Parameter

[in, optional] SocketContext

Ein Zeiger auf den Socketkontext für den Überwachungssocket, auf dem die eingehende Verbindungsanforderung empfangen wurde. Die WSK-Anwendung hat diesen Zeiger auf das WSK-Subsystem bereitgestellt, wenn sie die WskSocket--Funktion aufgerufen hat, um den Überwachungssocket zu erstellen.

[in] InspectID

Ein Zeiger auf eine WSK_INSPECT_ID Struktur. Der Inhalt der Struktur identifiziert die eingehende Verbindungsanforderung, die gelöscht wurde.

Rückgabewert

Die WskAbortEvent- Ereignisrückruffunktion einer WSK-Anwendung muss immer STATUS_SUCCESS zurückgeben.

Bemerkungen

Das WSK-Subsystem ruft die WskAbortEvent Ereignisrückruffunktion einer WSK-Anwendung nur auf, wenn die folgenden Bedingungen erfüllt sind:

Die WSK-Anwendung hat einen Überwachungssocket erstellt, der den Modus für die bedingte Annahme aktiviert hat.
Im Überwachungssocket wurde eine eingehende Verbindungsanforderung empfangen, und das WSK-Subsystem hat die WskInspectEvent- Ereignisrückruffunktion der WSK-Anwendung aufgerufen.
Die WSK-Anwendung hat WskInspectPend oder WskInspectAccept von der WskAbortEvent Ereignisrückruffunktion für die eingehende Verbindungsanforderung zurückgegeben.
Die eingehende Verbindungsanforderung wurde entweder lokal oder remote abgelegt, bevor sie vollständig eingerichtet wurde.

Wenn das WSK-Subsystem die WskAbortEvent Ereignisrückruffunktion einer WSK-Anwendung aufruft, sollte die Anwendung die Prüfung für die eingehende Verbindungsanforderung beenden. Die Verbindungsanforderung wird durch den Inhalt der WSK_INSPECT_ID Struktur identifiziert, auf die der InspectID Parameter verweist.

Wenn die WSK-Anwendung die WskInspectComplete--Funktion für eine eingehende Verbindungsanforderung aufruft, die abgebrochen wurde, wird die Verbindung nicht hergestellt, auch wenn WskInspectAccept- im parameter Action angegeben wird.

Eine WSK-Anwendung kann den Modus für die bedingte Annahme in einem Überwachungssocket aktivieren, indem die SO_CONDITIONAL_ACCEPT Socketoption aktiviert wird. Weitere Informationen zum bedingten Annehmen eingehender Verbindungen finden Sie unter Überwachung und Annehmen eingehender Verbindungen.

Das WSK-Subsystem ruft die WskAbortEvent Ereignisrückruffunktion einer WSK-Anwendung bei IRQL <= DISPATCH_LEVEL auf.

Die WskAbortEvent- Ereignisrückruffunktion einer WSK-Anwendung darf nicht auf den Abschluss anderer WSK-Anforderungen im Kontext von WSK-Abschluss- oder Ereignisrückruffunktionen warten. Der Rückruf kann andere WSK-Anforderungen initiieren (vorausgesetzt, es verbringt nicht zu viel Zeit bei DISPATCH_LEVEL), aber er darf nicht auf den Abschluss warten, auch wenn der Rückruf bei IRQL = PASSIVE_LEVEL aufgerufen wird.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Fenster
Header-	wsk.h (include Wsk.h)
IRQL-	<= DISPATCH_LEVEL