WSK_PROVIDER_DISPATCH Struktur (wsk.h)

2025-02-07

Die WSK_PROVIDER_DISPATCH Struktur gibt die Verteilertabelle 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;

Angehörige

Version

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

Reserved

Reserviert für die Systemverwendung.

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.

Bemerkungen

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

Die Haupt- und Nebenversionsnummern, die im Version Member enthalten sind, werden mithilfe des MAKE_WSK_VERSION-Makros codiert:

Version = MAKE_WSK_VERSION(Major,Minor);

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

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

Die Nebenversionsnummer, die im Version Mitglied dieser Struktur enthalten ist, kann eine höhere Nebenversionsnummer sein als die von der WSK-Anwendung im Version Mitglied der WSK_CLIENT_DISPATCH Struktur angefordert wurde. Diese Situation sollte kein Problem für die WSK-Anwendung verursachen, da höhere Nebenversionen des WSK NPI eine strenge Obermenge niedrigerer Nebenversionen des WSK NPI sind, wenn sie dieselbe Hauptversionsnummer haben. Das WSK-Subsystem gibt die verbleibenden Member der WSK_PROVIDER_DISPATCH Struktur an, um der Version des WSK NPI zu entsprechen, die im Version Mitglied der Struktur angegeben ist.

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