WSK_PROVIDER_DISPATCH-Struktur (wsk.h)
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) |