structure WSK_PROVIDER_CONNECTION_DISPATCH (wsk.h)

Article
02/27/2024

La structure WSK_PROVIDER_CONNECTION_DISPATCH spécifie la table des fonctions du sous-système WSK pour un socket orienté connexion.

Syntaxe

typedef struct _WSK_PROVIDER_CONNECTION_DISPATCH {
  WSK_PROVIDER_BASIC_DISPATCH          Basic;
  PFN_WSK_BIND                         WskBind;
  PFN_WSK_CONNECT                      WskConnect;
  PFN_WSK_GET_LOCAL_ADDRESS            WskGetLocalAddress;
  PFN_WSK_GET_REMOTE_ADDRESS           WskGetRemoteAddress;
  PFN_WSK_SEND                         WskSend;
  PFN_WSK_RECEIVE                      WskReceive;
  PFN_WSK_DISCONNECT                   WskDisconnect;
  PFN_WSK_RELEASE_DATA_INDICATION_LIST WskRelease;
  PFN_WSK_CONNECT_EX                   WskConnectEx;
  PFN_WSK_SEND_EX                      WskSendEx;
  PFN_WSK_RECEIVE_EX                   WskReceiveEx;
} WSK_PROVIDER_CONNECTION_DISPATCH, *PWSK_PROVIDER_CONNECTION_DISPATCH;

Membres

Basic

Les membres du WSK_PROVIDER_BASIC_DISPATCH structure sont incluses en tant que membres de la structure WSK_PROVIDER_CONNECTION_DISPATCH .

WskBind

Pointeur vers la fonction WskBind du sous-système WSK pour le socket.

WskConnect

Pointeur vers la fonction WskConnect du sous-système WSK pour le socket.

WskGetLocalAddress

Pointeur vers la fonction WskGetLocalAddress du sous-système WSK pour le socket.

WskGetRemoteAddress

Pointeur vers la fonction WskGetRemoteAddress du sous-système WSK pour le socket.

WskSend

Pointeur vers la fonction WskSend du sous-système WSK pour le socket.

WskReceive

Pointeur vers la fonction WskReceive du sous-système WSK pour le socket.

WskDisconnect

Pointeur vers la fonction WskDisconnect du sous-système WSK pour le socket.

WskRelease

Pointeur vers la fonction WskRelease du sous-système WSK pour le socket.

WskConnectEx

Pointeur vers la fonction WskConnectEx du sous-système WSK pour le socket.

WskSendEx

Ce membre est réservé à l’utilisation du système.

WskReceiveEx

Ce membre est réservé à l’utilisation du système.

Remarques

La liste des membres de la structure WSK_PROVIDER_CONNECTION_DISPATCH inclut un nom non nommé WSK_PROVIDER_BASIC_DISPATCH structure. Le compilateur inclus avec le WDK prend en charge une extension spécifique à Microsoft au langage C qui autorise les structures sans nom dans les déclarations de structure. Il en résulte que les membres de structure de la structure WSK_PROVIDER_BASIC_DISPATCH sont inclus dans la structure WSK_PROVIDER_CONNECTION_DISPATCH comme s’ils étaient des membres natifs de la structure WSK_PROVIDER_CONNECTION_DISPATCH.

Une application WSK reçoit un pointeur vers une structure WSK_PROVIDER_CONNECTION_DISPATCH de l’une des manières suivantes :

L’application WSK appelle la fonction WskSocket pour créer un socket orienté connexion.
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.

Le pointeur vers la structure WSK_PROVIDER_CONNECTION_DISPATCH est contenu dans le membre Dispatch de la structure WSK_SOCKET qui est reçu du sous-système WSK.

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)