WSK_PROVIDER_DISPATCH-Struktur (wsk.h)

Artikel
08/08/2023

Die WSK_PROVIDER_DISPATCH-Struktur gibt die Dispatchtabelle des WSK-Subsystems mit Funktionen an, die nicht spezifisch für einen bestimmten Socket sind.

Syntax

typedef struct _WSK_PROVIDER_DISPATCH {
  USHORT                    Version;
  USHORT                    Reserved;
  PFN_WSK_SOCKET            WskSocket;
  PFN_WSK_SOCKET_CONNECT    WskSocketConnect;
  PFN_WSK_CONTROL_CLIENT    WskControlClient;
  PFN_WSK_GET_ADDRESS_INFO  WskGetAddressInfo;
  PFN_WSK_FREE_ADDRESS_INFO WskFreeAddressInfo;
  PFN_WSK_GET_NAME_INFO     WskGetNameInfo;
} WSK_PROVIDER_DISPATCH, *PWSK_PROVIDER_DISPATCH;

Member

Version

Die Version der WSK-Netzwerkprogrammierschnittstelle (Network Programming Interface, NPI), die das WSK-Subsystem für die Anlage an die WSK-Anwendung verwendet.

Reserved

Ist für das System reserviert.

WskSocket

Ein Zeiger auf die WskSocket-Funktion des WSK-Subsystems .

WskSocketConnect

Ein Zeiger auf die WskSocketConnect-Funktion des WSK-Subsystems .

WskControlClient

Ein Zeiger auf die WskControlClient-Funktion des WSK-Subsystems .

WskGetAddressInfo

Ein Zeiger auf die WskGetAddressInfo-Funktion des WSK-Subsystems .

Dieses Mitglied ist ab Windows 7 verfügbar.

WskFreeAddressInfo

Ein Zeiger auf die WskFreeAddressInfo-Funktion des WSK-Subsystems .

Dieses Mitglied ist ab Windows 7 verfügbar.

WskGetNameInfo

Ein Zeiger auf die WskGetNameInfo-Funktion des WSK-Subsystems .

Dieses Mitglied ist ab Windows 7 verfügbar.

Hinweise

Wenn eine WSK-Anwendung die WskCaptureProviderNPI-Funktion aufruft, gibt das WSK-Subsystem mithilfe des Dispatch-Elements der WSK_CLIENT_NPI Struktur, auf die der WskProviderNpi-Parameter verweist, einen Zeiger auf eine WSK_PROVIDER_DISPATCH-Struktur zurück.

Die Im Versionsmember enthaltenen Haupt- und Nebenversionsnummern werden mithilfe des makros MAKE_WSK_VERSION codiert:

Version = MAKE_WSK_VERSION(Major,Minor);

Die Haupt- und Nebenversionsnummern können mithilfe der makros WSK_MAJOR_VERSION und WSK_MINOR_VERSION aus dem Versionselement extrahiert werden:

Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);

Die Nummer der Nebenversion, die im Versionsmember dieser Struktur enthalten ist, kann eine höhere Nebenversionsnummer sein, als von der WSK-Anwendung im Versionselement der WSK_CLIENT_DISPATCH-Struktur angefordert wurde. Diese Situation sollte kein Problem für die WSK-Anwendung verursachen, da höhere Nebenversionen der WSK-NPI eine strikte Obermenge niedrigerer Nebenversionen des WSK-NPI darstellen, wenn sie über die gleiche Hauptversionsnummer verfügen. Das WSK-Subsystem gibt die verbleibenden Member der WSK_PROVIDER_DISPATCH-Struktur an, um der Version des WSK-NPI zu entsprechen, die im Versionselement der -Struktur angegeben ist.

Weitere Informationen zum Anfügen einer WSK-Anwendung an das WSK-Subsystem finden Sie unter Registrieren einer Winsock-Kernelanwendung.

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)