WSK_INSPECT_ID-Struktur (wsk.h)

Die WSK_INSPECT_ID-Struktur gibt einen Bezeichner für eine eingehende Verbindungsanforderung an einem Lauschocket an.

Syntax

typedef struct _WSK_INSPECT_ID {
  ULONG_PTR Key;
  ULONG     SerialNumber;
} WSK_INSPECT_ID, *PWSK_INSPECT_ID;

Member

Key

Ein Schlüssel, der der eingehenden Verbindungsanforderung zugewiesen ist.

SerialNumber

Eine Seriennummer, die der eingehenden Verbindungsanforderung zugewiesen ist.

Hinweise

Das WSK-Subsystem übergibt einen Zeiger auf eine WSK_INSPECT_ID-Struktur an die WskInspectEvent-Ereignisrückruffunktion einer WSK-Anwendung, wenn eine eingehende Verbindungsanforderung auf einem Überwachungssocket eingeht, in dem der bedingte Annahmemodus aktiviert ist. Der Inhalt der WSK_INSPECT_ID Struktur identifiziert eindeutig die eingehende Verbindungsanforderung.

Wenn die WSK-Anwendung WskInspectPend von einem Aufruf ihrer WskInspectEvent-Ereignisrückruffunktion zurückgibt, muss die Anwendung zuerst den Inhalt der vom WSK-Subsystem bereitgestellten WSK_INSPECT_ID Struktur in eine eigene WSK_INSPECT_ID-Struktur kopieren. Die WSK-Anwendung übergibt dann einen Zeiger auf ihre WSK_INSPECT_ID-Struktur an die WskInspectComplete-Funktion , wenn sie die Überprüfung abgeschlossen hat.

Wenn die eingehende Verbindungsanforderung vom Remotesystem gelöscht wird, während ein Überprüfungsvorgang aussteht, ruft das WSK-Subsystem die WskAbortEvent-Ereignisrückruffunktion der WSK-Anwendung mit einem Zeiger auf eine WSK_INSPECT_ID-Struktur auf, die die gelöschte Anforderung identifiziert. Die WSK-Anwendung verwendet den Inhalt dieser WSK_INSPECT_ID-Struktur, um zu bestimmen, welche Überprüfung einer eingehenden Verbindungsanforderung beendet werden soll. Die WSK-Anwendung sollte den Inhalt der WSK_INSPECT_ID Strukturen vergleichen, um nach einer Übereinstimmung zu suchen. Die tatsächlichen Werte der Strukturmember sind irrelevant.

Eine WSK-Anwendung kann den bedingten Annahmemodus für einen Lauschocket aktivieren, indem sie die SO_CONDITIONAL_ACCEPT-Socketoption aktiviert. Weitere Informationen zum bedingten Akzeptieren eingehender Verbindungen finden Sie unter Überwachen und Akzeptieren eingehender Connections.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	wsk.h (einschließen von Wsk.h)

Weitere Informationen

SO_CONDITIONAL_ACCEPT

WskAbortEvent

WskInspectComplete

WskInspectEvent