PFN_WSK_ABORT_EVENT Rückruffunktion (wsk.h)
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 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 |