структура WSK_PROVIDER_DISPATCH (wsk.h)

Статья
08/08/2023

Структура WSK_PROVIDER_DISPATCH определяет таблицу диспетчеризации подсистемы WSK функций, не относящихся к конкретному сокету.

Синтаксис

typedef struct _WSK_PROVIDER_DISPATCH {
  USHORT                    Version;
  USHORT                    Reserved;
  PFN_WSK_SOCKET            WskSocket;
  PFN_WSK_SOCKET_CONNECT    WskSocketConnect;
  PFN_WSK_CONTROL_CLIENT    WskControlClient;
  PFN_WSK_GET_ADDRESS_INFO  WskGetAddressInfo;
  PFN_WSK_FREE_ADDRESS_INFO WskFreeAddressInfo;
  PFN_WSK_GET_NAME_INFO     WskGetNameInfo;
} WSK_PROVIDER_DISPATCH, *PWSK_PROVIDER_DISPATCH;

Члены

Version

Версия сетевого программного интерфейса WSK (NPI), которую подсистема WSK будет использовать для присоединения к приложению WSK.

Reserved

Зарезервировано для системного использования.

WskSocket

Указатель на функцию WskSocket подсистемы WSK.

WskSocketConnect

Указатель на функцию WskSocketConnect подсистемы WSK.

WskControlClient

Указатель на функцию WskControlClient подсистемы WSK.

WskGetAddressInfo

Указатель на функцию WskGetAddressInfo подсистемы WSK.

Этот элемент доступен начиная с Windows 7.

WskFreeAddressInfo

Указатель на функцию WskFreeAddressInfo подсистемы WSK.

Этот элемент доступен начиная с Windows 7.

WskGetNameInfo

Указатель на функцию WskGetNameInfo подсистемы WSK.

Этот элемент доступен начиная с Windows 7.

Когда приложение WSK вызывает функцию WskCaptureProviderNPI , подсистема WSK возвращает указатель на структуру WSK_PROVIDER_DISPATCH с помощью элемента Dispatchструктуры WSK_CLIENT_NPI , на которую указывает параметр WskProviderNpi .

Основные и дополнительные номера версий, содержащиеся в элементе Version , кодируются с помощью макроса MAKE_WSK_VERSION:

Version = MAKE_WSK_VERSION(Major,Minor);

Основные и дополнительные номера версий можно извлечь из элемента Version с помощью макросов WSK_MAJOR_VERSION и WSK_MINOR_VERSION:

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

Дополнительный номер версии, содержащийся в элементе Version этой структуры, может быть более высоким, чем номер дополнительной версии, запрошенный приложением WSK в элементе Versionструктуры WSK_CLIENT_DISPATCH . Эта ситуация не должна вызывать проблемы для приложения WSK, так как более высокие дополнительные версии WSK NPI являются строгим надмножеством более низких дополнительных версий NPI WSK, если они имеют одинаковый номер основной версии. Подсистема WSK укажет остальные члены структуры WSK_PROVIDER_DISPATCH в соответствии с версией NPI WSK, указанной в элементе Version структуры.

Дополнительные сведения о присоединении приложения WSK к подсистеме WSK см. в разделе Регистрация приложения ядра Winsock.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Верхняя часть	wsk.h (включая Wsk.h)