structure WSK_PROVIDER_DISPATCH (wsk.h)
La structure WSK_PROVIDER_DISPATCH spécifie la table de distribution 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
La version de WSK Network Programming Interface (NPI) que le sous-système WSK utilisera pour sa pièce jointe à l’application WSK.
Reserved
Réservé à l’utilisation du 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 WSK WskGetAddressInfo.
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 principaux et secondaires 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 secondaire 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 la version membre de cette structure peut être un numéro de version secondaire supérieur à ce qui a été demandé par l’application WSK dans la version version membre de la structure WSK_CLIENT_DISPATCH. Cette situation ne doit pas entraîner de problème pour l’application WSK, car les versions mineures supérieures de l’indicateur de sécurité réseau WSK sont un super-ensemble strict de versions mineures inférieures de l’indicateur de sécurité réseau WSK s’ils ont le même numéro de version principale. Le sous-système WSK spécifie les membres restants de la structure WSK_PROVIDER_DISPATCH à respecter la version du NPI WSK indiquée dans le Version membre 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| d’en-tête | wsk.h (include Wsk.h) |