structure WSK_PROVIDER_DISPATCH (wsk.h)

Article
02/27/2024

La structure WSK_PROVIDER_DISPATCH spécifie la table de répartition du sous-système WSK des fonctions qui ne sont pas spécifiques à un socket particulier.

Syntaxe

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;

Membres

Version

Version de l’interface de programmation réseau WSK (NPI) que le sous-système WSK utilisera pour sa pièce jointe à l’application WSK.

Reserved

Réservé pour le système.

WskSocket

Pointeur vers la fonction WskSocket du sous-système WSK.

WskSocketConnect

Pointeur vers la fonction WskSocketConnect du sous-système WSK.

WskControlClient

Pointeur vers la fonction WskControlClient du sous-système WSK.

WskGetAddressInfo

Pointeur vers la fonction WskGetAddressInfo du sous-système WSK.

Ce membre est disponible à partir de Windows 7.

WskFreeAddressInfo

Pointeur vers la fonction WskFreeAddressInfo du sous-système WSK.

Ce membre est disponible à partir de Windows 7.

WskGetNameInfo

Pointeur vers la fonction WskGetNameInfo du sous-système WSK.

Ce membre est disponible à partir de Windows 7.

Remarques

Lorsqu’une application WSK appelle la fonction WskCaptureProviderNPI , le sous-système WSK retourne un pointeur vers une structure WSK_PROVIDER_DISPATCH au moyen du membre Dispatch de la structure WSK_CLIENT_NPI pointée par le paramètre WskProviderNpi .

Les numéros de version principale et secondaire contenus dans le membre Version sont encodés à l’aide de la macro MAKE_WSK_VERSION :

Version = MAKE_WSK_VERSION(Major,Minor);

Les numéros de version principale et mineure peuvent être extraits du membre Version à l’aide des macros WSK_MAJOR_VERSION et WSK_MINOR_VERSION :

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

Le numéro de version secondaire contenu dans le membre Version de cette structure peut être un numéro de version secondaire supérieur à celui demandé par l’application WSK dans le membre Version de la structure WSK_CLIENT_DISPATCH . Cette situation ne doit pas causer de problème pour l’application WSK, car les versions mineures supérieures du NPI WSK sont un sur-ensemble strict de versions mineures inférieures du NPI WSK si elles ont le même numéro de version majeure. Le sous-système WSK spécifie les membres restants de la structure WSK_PROVIDER_DISPATCH pour qu’ils soient conformes à la version du NPI WSK indiquée dans le membre Version de la structure.

Pour plus d’informations sur l’attachement d’une application WSK au sous-système WSK, consultez Inscription d’une application de noyau Winsock.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	wsk.h (inclure Wsk.h)