estrutura WSK_PROVIDER_DISPATCH (wsk.h)

  • Artigo

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)

Confira também

WSK_CLIENT_DISPATCH

WSK_CLIENT_NPI

WskCaptureProviderNPI

WskControlClient

WskSocket

WskSocketConnect