Partager via


structure WSK_PROVIDER_CHARACTERISTICS (wsk.h)

La structure WSK_PROVIDER_CHARACTERISTICS spécifie les caractéristiques du sous-système WSK.

Syntaxe

typedef struct _WSK_PROVIDER_CHARACTERISTICS {
  USHORT HighestVersion;
  USHORT LowestVersion;
} WSK_PROVIDER_CHARACTERISTICS, *PWSK_PROVIDER_CHARACTERISTICS;

Membres

HighestVersion

La version la plus élevée de WSK Network Programming Interface (NPI) prise en charge par le sous-système WSK.

LowestVersion

Version la plus basse de l’indicateur de sécurité réseau WSK prise en charge par le sous-système WSK.

Remarques

Lorsqu’un appel WskCaptureProviderN PI échoue avec le code d’état STATUS_NOINTERFACE, l’application WSK peut utiliser un appel pour WskQueryProviderCharacterCharacteristics pour interroger la plage de versions de NPI WSK prises en charge par le sous-système WSK. WskQueryProviderCharacteristics retourne les informations de version au moyen de la structure WSK_PROVIDER_CHARACTERISTICS. Une application WSK peut utiliser ces informations pour déterminer si le sous-système WSK prend en charge une version du NPI WSK compatible avec l’application.

Les numéros de version principaux et secondaires contenus dans le HighestVersion et les membres LowestVersion 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 des HighestVersion et des membres LowestVersion à l’aide des macros WSK_MAJOR_VERSION et WSK_MINOR_VERSION :

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

Si une application WSK détermine que le sous-système WSK prend en charge une version du NPI WSK compatible avec l’application, l’application doit appeler WskRegister et, au moyen du membre Dispatch de la structure WSK_CLIENT_NPI pointée par le paramètre WskClientNpi, il doit spécifier la version exacte du NPI WSK qu’elle souhaite utiliser dans le Version membre de la structure WSK_CLIENT_DISPATCH. L’application WSK doit spécifier les membres restants de la structure WSK_CLIENT_DISPATCH pour qu’elle soit conforme à la version du NPI WSK spécifié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)

Voir aussi

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskQueryProviderCharacteristics

WskRegister