NSP_ROUTINE structure (ws2spi.h)

The NSP_ROUTINE structure contains information regarding the functions implemented by a namespace service provider version 1 (NSPv1) provider.

**Note**  The Ws2spi.h header file structure contains complete prototypes for all the NSPv1 function pointers.
 

Syntax

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;

Members

cbSize

Type: DWORD

The size, in bytes, of the structure. Note that the size of the NSP_ROUTINE structure changed on Windows XP and later.

dwMajorVersion

Type: DWORD

The major version of the service provider specification supported by this provider.

dwMinorVersion

Type: DWORD

The minor version of the service provider specification supported by this provider.

NSPCleanup

Type: LPNSPCLEANUP

A pointer to the NSPCleanup function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPCleanup function should return WSAEOPNOTSUPP.

NSPLookupServiceBegin

Type: LPNSPLOOKUPSERVICEBEGIN

A pointer to the NSPLookupServiceBegin function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPLookupServiceBegin function should return WSAEOPNOTSUPP.

NSPLookupServiceNext

Type: LPNSPLOOKUPSERVICENEXT

A pointer to the NSPLookupServiceNext function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPLookupServiceNext function should return WSAEOPNOTSUPP.

NSPLookupServiceEnd

Type: LPNSPLOOKUPSERVICEEND

A pointer to the NSPLookupServiceEnd function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPLookupServiceEnd function should return WSAEOPNOTSUPP.

NSPSetService

Type: LPNSPSETSERVICE

A pointer to the NSPSetService function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPSetService function should return WSAEOPNOTSUPP.

NSPInstallServiceClass

Type: LPNSPINSTALLSERVICECLASS

A pointer to the NSPInstallServiceClass function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPInstallServiceClass function should return WSAEOPNOTSUPP.

NSPRemoveServiceClass

Type: LPNSPREMOVESERVICECLASS

A pointer to the NSPRemoveServiceClass function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPRemoveServiceClass function should return WSAEOPNOTSUPP.

NSPGetServiceClassInfo

Type: LPNSPGETSERVICECLASSINFO

A pointer to the NSPGetServiceClassInfo function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPGetServiceClassInfo function should return WSAEOPNOTSUPP.

NSPIoctl

Type: LPNSPIOCTL

A pointer to the NSPIoctl function implemented by the namespace provider. Every NSP function entry must point to a valid function. If the provider does not implement this function, the NSPIoctl function should return WSAEOPNOTSUPP.

**Note**  This structure member is only available on Windows XP and later.
 

Remarks

The size of the NSP_ROUTINE structure changed on Windows XP and later. The cbSize member should be used to determine which version of the NSP_ROUTINE structure is being used.

The version of the NSP_ROUTINE structure on Windows XP and later has the following new member added: NSPIoctl.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header ws2spi.h

See also

NSPCleanup

NSPGetServiceClassInfo

NSPInstallServiceClass

NSPIoctl

NSPLookupServiceBegin

NSPLookupServiceEnd

NSPLookupServiceNext

NSPRemoveServiceClass

NSPSetService

NSPStartup

NSPV2_ROUTINE