NSP_ROUTINE 结构 (ws2spi.h)

项目
03/13/2024

NSP_ROUTINE 结构包含有关命名空间服务提供程序版本 1 (NSPv1) 提供程序实现的函数的信息。

**注意** Ws2spi.h 头文件结构包含所有 NSPv1 函数指针的完整原型。

语法

typedef struct _NSP_ROUTINE {
  DWORD                    cbSize;
  DWORD                    dwMajorVersion;
  DWORD                    dwMinorVersion;
  LPNSPCLEANUP             NSPCleanup;
  LPNSPLOOKUPSERVICEBEGIN  NSPLookupServiceBegin;
  LPNSPLOOKUPSERVICENEXT   NSPLookupServiceNext;
  LPNSPLOOKUPSERVICEEND    NSPLookupServiceEnd;
  LPNSPSETSERVICE          NSPSetService;
  LPNSPINSTALLSERVICECLASS NSPInstallServiceClass;
  LPNSPREMOVESERVICECLASS  NSPRemoveServiceClass;
  LPNSPGETSERVICECLASSINFO NSPGetServiceClassInfo;
  LPNSPIOCTL               NSPIoctl;
} NSP_ROUTINE, *LPNSP_ROUTINE;

成员

cbSize

类型：DWORD

结构的大小（以字节为单位）。请注意，Windows XP 及更高版本上 NSP_ROUTINE 结构的大小已更改。

dwMajorVersion

类型：DWORD

此提供程序支持的服务提供商规范的主版本。

dwMinorVersion

类型：DWORD

此提供程序支持的服务提供商规范的次要版本。

NSPCleanup

类型： LPNSPCLEANUP

指向命名空间提供程序实现的 NSPCleanup 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPCleanup 函数应返回 WSAEOPNOTSUPP。

NSPLookupServiceBegin

类型： LPNSPLOOKUPSERVICEBEGIN

指向由命名空间提供程序实现的 NSPLookupServiceBegin 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPLookupServiceBegin 函数应返回 WSAEOPNOTSUPP。

NSPLookupServiceNext

类型： LPNSPLOOKUPSERVICENEXT

指向由命名空间提供程序实现的 NSPLookupServiceNext 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPLookupServiceNext 函数应返回 WSAEOPNOTSUPP。

NSPLookupServiceEnd

类型： LPNSPLOOKUPSERVICEEND

指向命名空间提供程序实现的 NSPLookupServiceEnd 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPLookupServiceEnd 函数应返回 WSAEOPNOTSUPP。

NSPSetService

类型： LPNSPSETSERVICE

指向命名空间提供程序实现的 NSPSetService 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPSetService 函数应返回 WSAEOPNOTSUPP。

NSPInstallServiceClass

类型： LPNSPINSTALLSERVICECLASS

指向命名空间提供程序实现的 NSPInstallServiceClass 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPInstallServiceClass 函数应返回 WSAEOPNOTSUPP。

NSPRemoveServiceClass

类型： LPNSPREMOVESERVICECLASS

指向命名空间提供程序实现的 NSPRemoveServiceClass 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPRemoveServiceClass 函数应返回 WSAEOPNOTSUPP。

NSPGetServiceClassInfo

类型： LPNSPGETSERVICECLASSINFO

指向由命名空间提供程序实现的 NSPGetServiceClassInfo 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPGetServiceClassInfo 函数应返回 WSAEOPNOTSUPP。

NSPIoctl

类型： LPNSPIOCTL

指向命名空间提供程序实现的 NSPIoctl 函数的指针。每个 NSP 函数条目都必须指向有效的函数。如果提供程序未实现此函数， 则 NSPIoctl 函数应返回 WSAEOPNOTSUPP。

**注意** 此结构成员仅适用于 Windows XP 及更高版本。

注解

Windows XP 及更高版本上 NSP_ROUTINE 结构的大小已更改。 cbSize 成员应用于确定正在使用哪个版本的 NSP_ROUTINE 结构。

Windows XP 和更高版本上的 NSP_ROUTINE 结构版本添加了以下新成员： NSPIoctl。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
标头	ws2spi.h