Freigeben über


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

Siehe auch

WSK_CLIENT_LISTEN_DISPATCH

WSK_INSPECT_ID

WskControlSocket-

WskInspectComplete-

WskInspectEvent-

WskSocket-