WSK_PROVIDER_CONNECTION_DISPATCH structure (wsk.h)

The WSK_PROVIDER_CONNECTION_DISPATCH structure specifies the WSK subsystem's table of functions for a connection-oriented socket.

Syntax

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;

Members

Basic

The members of the WSK_PROVIDER_BASIC_DISPATCH structure are included as members of the WSK_PROVIDER_CONNECTION_DISPATCH structure.

WskBind

A pointer to the WSK subsystem's WskBind function for the socket.

WskConnect

A pointer to the WSK subsystem's WskConnect function for the socket.

WskGetLocalAddress

A pointer to the WSK subsystem's WskGetLocalAddress function for the socket.

WskGetRemoteAddress

A pointer to the WSK subsystem's WskGetRemoteAddress function for the socket.

WskSend

A pointer to the WSK subsystem's WskSend function for the socket.

WskReceive

A pointer to the WSK subsystem's WskReceive function for the socket.

WskDisconnect

A pointer to the WSK subsystem's WskDisconnect function for the socket.

WskRelease

A pointer to the WSK subsystem's WskRelease function for the socket.

WskConnectEx

A pointer to the WSK subsystem's WskConnectEx function for the socket.

WskSendEx

This member is reserved for system use.

WskReceiveEx

This member is reserved for system use.

Remarks

The member list of the WSK_PROVIDER_CONNECTION_DISPATCH structure includes an unnamed WSK_PROVIDER_BASIC_DISPATCH structure. The compiler that is included with the WDK supports a Microsoft-specific extension to the C language that allows unnamed structures within structure declarations. The result is that the structure members of the WSK_PROVIDER_BASIC_DISPATCH structure are included in the WSK_PROVIDER_CONNECTION_DISPATCH structure as if they were native members of the WSK_PROVIDER_CONNECTION_DISPATCH structure.

A WSK application receives a pointer to a WSK_PROVIDER_CONNECTION_DISPATCH structure in one of the following ways:

• The WSK application calls the WskSocket function to create a connection-oriented socket.
• The WSK application calls the WskSocketConnect function to create, bind, and connect a connection-oriented socket.
• The WSK application calls the WskAccept function to accept an incoming connection-oriented socket on a listening socket.
• The WSK subsystem calls the WSK application's WskAcceptEvent event callback function to notify the WSK application that an incoming connection-oriented socket has been accepted on a listening socket.

The pointer to the WSK_PROVIDER_CONNECTION_DISPATCH structure is contained in the Dispatch member of the WSK_SOCKET structure that is received from the WSK subsystem.

Requirements

Requirement	Value
Minimum supported client	Available in Windows Vista and later versions of the Windows operating systems.
Header	wsk.h (include Wsk.h)

See also

WSK_CLIENT_CONNECTION_DISPATCH

WSK_PROVIDER_BASIC_DISPATCH

WSK_SOCKET

WskAccept

WskAcceptEvent

WskBind

WskCloseSocket

WskConnect

WskControlSocket

WskDisconnect

WskGetLocalAddress

WskGetRemoteAddress

WskReceive

WskRelease

WskSend

WskSocket

WskSocketConnect