structure WSK_SOCKET (wsk.h)

Article
08/08/2023

La structure WSK_SOCKET définit un objet socket pour un socket.

Syntaxe

typedef struct _WSK_SOCKET {
  const VOID *Dispatch;
} WSK_SOCKET, *PWSK_SOCKET;

Membres

Dispatch

Pointeur vers une structure de répartition de fournisseur constant. Cette structure est une table de répartition qui contient des pointeurs vers les fonctions d’un socket. Selon la catégorie de socket WSK du socket, ce pointeur est un pointeur vers l’une des structures suivantes :

Catégorie de socket	Structure de table de répartition
Socket de base	WSK_PROVIDER_BASIC_DISPATCH
Socket d’écoute	WSK_PROVIDER_LISTEN_DISPATCH
Socket de datagramme	WSK_PROVIDER_DATAGRAM_DISPATCH
Socket orienté connexion	WSK_PROVIDER_CONNECTION_DISPATCH
Stream socket	WSK_PROVIDER_STREAM_DISPATCH

Remarques

Le sous-système WSK alloue et remplit une structure WSK_SOCKET chaque fois qu’un nouveau socket est créé. Une application WSK reçoit un pointeur vers la structure WSK_SOCKET pour un socket à partir du sous-système WSK de l’une des manières suivantes :

L’application WSK appelle la fonction WskSocket pour créer un socket.
L’application WSK appelle la fonction WskSocketConnect pour créer, lier et connecter un socket orienté connexion.
L’application WSK appelle la fonction WskAccept pour accepter un socket entrant orienté connexion sur un socket d’écoute.
Le sous-système WSK appelle la fonction de rappel d’événement WskAcceptEvent de l’application WSK pour informer l’application WSK qu’un socket entrant orienté connexion a été accepté sur un socket d’écoute.

Une application WSK transmet le pointeur vers la structure WSK_SOCKET d’un socket lors de l’appel de l’une des fonctions du socket.

Le sous-système WSK libère la mémoire pour la structure WSK_SOCKET lorsque l’application WSK appelle la fonction WskCloseSocket pour fermer le socket.

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)