WSK_PROVIDER_DISPATCH結構 (wsk.h)

發行項
03/01/2024

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 子系統會透過 WskProviderNpi 參數所指向之WSK_CLIENT_NPI結構的 Dispatch 成員傳回WSK_PROVIDER_DISPATCH結構的指標。

版本 成員中包含的 主要和次要版本號碼會使用 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 子系統會指定WSK_PROVIDER_DISPATCH結構的其餘成員，以符合結構版本成員中所指出的 WSK NPI 版本。

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