NSP_ROUTINE結構 (ws2spi.h)

發行項
08/28/2023

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