NSPInstallServiceClass

The NSPInstallServiceClass function registers service class schema within the name space providers.

The schema includes the class name, class id, and any name space-specific type information that is common to all instances of the service, such as SAP ID or object ID. A dynamic name space provider is expected to store any class information associated with that namespace. Other name space providers should do whatever makes sense.

int NSPInstallServiceClass (
  LPGUID lpProviderId,                       
  LPWSASERVICECLASSINFOW lpServiceClassInfo  
);
 

Parameters

lpProviderId
[in] Pointer to the GUID of the specific name space provider that this service class schema is being registered in.
lpServiceClasslnfo
[in] Contains service class schema information.

Remarks

Name space providers are encouraged, but not required to store information that is specific to the name space that they suport.

Return Values

The function should return NO_ERROR (zero) if the routine succeeds. It should return SOCKET_ERROR (-1) if the routine fails and it must set the appropriate error code using SetLastError.

Error Codes

WSAEACCES The calling routine does not have sufficient privileges to perform this operation.
WSAEALREADY Service class information has already been registered for this service class ID. To modify service class info, first use NSPRemoveServiceClass, then re-install with updated class info data.
WSAEINVAL The service class ID was invalid or improperly structured.
WSA_INVALID_PARAMETER The name space provider cannot supply the requested class information.
WSA_NOT_ENOUGH_MEMORY Not enough free memory available to perform this operation.

QuickInfo

  Windows NT: Yes
  Windows: Yes
  Windows CE: Unsupported.
  Header: Declared in ws2spi.h.