estrutura WSK_PROVIDER_DISPATCH (wsk.h)
A estrutura WSK_PROVIDER_DISPATCH especifica a tabela de expedição do subsistema WSK de funções que não são específicas de um soquete específico.
Sintaxe
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;
Membros
Version
A versão da NPI (Interface de Programação de Rede) do WSK que o subsistema WSK usará para seu anexo ao aplicativo WSK.
Reserved
Reservado para uso do sistema.
WskSocket
Um ponteiro para a função WskSocket do subsistema WSK.
WskSocketConnect
Um ponteiro para a função WskSocketConnect do subsistema WSK.
WskControlClient
Um ponteiro para a função WskControlClient do subsistema WSK.
WskGetAddressInfo
Um ponteiro para a função WskGetAddressInfo do subsistema WSK.
Esse membro está disponível a partir do Windows 7.
WskFreeAddressInfo
Um ponteiro para a função WskFreeAddressInfo do subsistema WSK.
Esse membro está disponível a partir do Windows 7.
WskGetNameInfo
Um ponteiro para a função WskGetNameInfo do subsistema WSK.
Esse membro está disponível a partir do Windows 7.
Comentários
Quando um aplicativo WSK chama a função WskCaptureProviderNPI , o subsistema WSK retorna um ponteiro para uma estrutura WSK_PROVIDER_DISPATCH por meio do membro Dispatch da estrutura WSK_CLIENT_NPI apontada pelo parâmetro WskProviderNpi .
Os números de versão principal e secundária contidos no membro Version são codificados usando a macro MAKE_WSK_VERSION:
Version = MAKE_WSK_VERSION(Major,Minor);
Os números de versão principal e secundária podem ser extraídos do membro Version usando as macros WSK_MAJOR_VERSION e WSK_MINOR_VERSION:
Major = WSK_MAJOR_VERSION(Version);
Minor = WSK_MINOR_VERSION(Version);
O número de versão secundária contido no membro Version dessa estrutura pode ser um número de versão menor maior do que o solicitado pelo aplicativo WSK no membro Version da estrutura WSK_CLIENT_DISPATCH . Essa situação não deve causar um problema para o aplicativo WSK porque versões secundárias mais altas do NPI do WSK são um superconjunto estrito de versões secundárias inferiores do NPI do WSK se tiverem o mesmo número de versão principal. O subsistema WSK especificará os membros restantes da estrutura WSK_PROVIDER_DISPATCH para estar em conformidade com a versão da NPI do WSK indicada no membro Version da estrutura.
Para obter mais informações sobre como anexar um aplicativo WSK ao subsistema WSK, consulte Registrando um aplicativo kernel Winsock.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| Cabeçalho | wsk.h (inclua Wsk.h) |