struttura WSK_PROVIDER_CONNECTION_DISPATCH (wsk.h)

Articolo
02/07/2025

La struttura WSK_PROVIDER_CONNECTION_DISPATCH specifica la tabella delle funzioni del sottosistema WSK per un socket orientato alla connessione.

Sintassi

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;

Membri

Basic

Membri dell'oggetto WSK_PROVIDER_BASIC_DISPATCH struttura sono inclusi come membri della struttura WSK_PROVIDER_CONNECTION_DISPATCH.

WskBind

Puntatore alla funzione di WskBind del sottosistema WskBind per il socket.

WskConnect

Puntatore alla funzione di WskConnect del sottosistema WskConnect per il socket.

WskGetLocalAddress

Puntatore al sottosistema WSK WskGetLocalAddress funzione per il socket.

WskGetRemoteAddress

Puntatore alla funzione WskGetRemoteAddress del sottosistema WskGetRemoteAddress per il socket.

WskSend

Puntatore alla funzione di WskSend del sottosistema WskSend del sottosistema WskSend per il socket.

WskReceive

Puntatore alla funzione di WskReceive del sottosistema WskReceive per il socket.

WskDisconnect

Puntatore alla funzione WskDisconnect del sottosistema WskDisconnect per il socket.

WskRelease

Puntatore alla funzione WskRelease del sottosistema WskRelease per il socket.

WskConnectEx

Puntatore alla funzione WskConnectEx del sottosistema WskConnectEx per il socket.

WskSendEx

Questo membro è riservato per l'uso del sistema.

WskReceiveEx

Questo membro è riservato per l'uso del sistema.

Osservazioni

L'elenco dei membri della struttura WSK_PROVIDER_CONNECTION_DISPATCH include un senza nome WSK_PROVIDER_BASIC_DISPATCH struttura. Il compilatore incluso in WDK supporta un'estensione specifica di Microsoft per il linguaggio C che consente strutture senza nome all'interno delle dichiarazioni di struttura. Il risultato è che i membri della struttura WSK_PROVIDER_BASIC_DISPATCH sono inclusi nella struttura WSK_PROVIDER_CONNECTION_DISPATCH come se fossero membri nativi della struttura WSK_PROVIDER_CONNECTION_DISPATCH.

Un'applicazione WSK riceve un puntatore a una struttura WSK_PROVIDER_CONNECTION_DISPATCH in uno dei modi seguenti:

L'applicazione WSK chiama la funzione WskSocket per creare un socket orientato alla connessione.
L'applicazione WSK chiama la funzione WskSocketConnect per creare, associare e connettere un socket orientato alla connessione.
L'applicazione WSK chiama la funzione WskAccept per accettare un socket orientato alla connessione in ingresso su un socket in ascolto.
Il sottosistema WSK chiama il WskAcceptEvent dell'applicazione WskAcceptEvent funzione di callback degli eventi per notificare all'applicazione WSK che un socket orientato alla connessione in ingresso è stato accettato in un socket di ascolto.

Il puntatore alla struttura WSK_PROVIDER_CONNECTION_DISPATCH è contenuto nel membro dispatch della struttura WSK_SOCKET ricevuta dal sottosistema WSK.