структура WSK_PROVIDER_DISPATCH (wsk.h)
Структура 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) |