WSK_PROVIDER_DISPATCH結構（wsk.h）

發行項
02/07/2025

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

WSK 子系統 WskSocket 函式的指標。

WskSocketConnect

WSK 子系統 WskSocketConnect 函式的指標。

WskControlClient

WSK 子系統 WskControlClient 函式的指標。

WskGetAddressInfo

WSK 子系統 WskGetAddressInfo 函式的指標。

此成員從 Windows 7 開始提供。

WskFreeAddressInfo

WSK 子系統 WskFreeAddressInfo 函式的指標。

此成員從 Windows 7 開始提供。

WskGetNameInfo

WSK 子系統 WskGetNameInfo 函式的指標。

此成員從 Windows 7 開始提供。

言論

當 WSK 應用程式呼叫 WskCaptureProviderNPI 函式時，WSK 子系統會透過 DispatchWSK_CLIENT_NPI 結構的成員，傳回 WskProviderNpi 參數所指向之 WSK_CLIENT_NPI 結構成員的 WSK_PROVIDER_DISPATCH指標。

Version 成員中包含的主要和次要版本號碼會使用 MAKE_WSK_VERSION 巨集來編碼：

Version = MAKE_WSK_VERSION(Major,Minor);

主要和次要版本號碼可以使用 WSK_MAJOR_VERSION 和 WSK_MINOR_VERSION 巨集，從 Version 成員擷取：

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

這個結構版本成員中包含的次要版本號碼，可能是比 WSK_CLIENT_DISPATCH 結構之 Version 成員中 WSK 應用程式所要求的次要版本號碼高。這種情況不應該對 WSK 應用程式造成問題，因為 WSK NPI 的次要版本較高，如果 WSK NPI 具有相同的主要版本號碼，則 WSK NPI 的次要版本是嚴格超集。 WSK 子系統會指定WSK_PROVIDER_DISPATCH結構的其餘成員，以符合結構版本成員中所指出的 WSK NPI 版本。

如需將 WSK 應用程式附加至 WSK 子系統的詳細資訊，請參閱註冊 Winsock 核心應用程式。