LPNSPINSTALLSERVICECLASS callback function (ws2spi.h)

Article
10/13/2021

The NSPInstallServiceClass function registers service class schema within the namespace providers.

The schema includes the class name, class identifier, and any namespace-specific type information that is common to all instances of the service, such as SAP identifier or object identifier. A dynamic namespace provider is expected to store any class information associated with that namespace.

Syntax

LPNSPINSTALLSERVICECLASS Lpnspinstallserviceclass;

INT Lpnspinstallserviceclass(
  [in] LPGUID lpProviderId,
  [in] LPWSASERVICECLASSINFOW lpServiceClassInfo
)
{...}

Parameters

[in] lpProviderId

A pointer to the GUID of the specific namespace provider that this service class schema is registered in.

[in] lpServiceClassInfo

A pointer to the service class schema information.

Return value

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 WSASetLastError.

Error code	Meaning
WSA_INVALID_PARAMETER	The namespace provider cannot supply the requested class information.
WSA_NOT_ENOUGH_MEMORY	There is not enough memory available to perform this operation.
WSAEACCES	The calling routine does not have sufficient privileges to perform this operation.
WSAEALREADY	The service class information has already been registered for this service class identifier. To modify service class information, first call NSPRemoveServiceClass, then reinstall with updated class information data.
WSAEINVAL	The service class identifier was invalid or improperly structured. This error is returned if the lpServiceClassInfo parameter is NULL.
WSAEOPNOTSUPP	The operation is not supported. This error is returned if the namespace provider does not implement this function.
WSANO_DATA	The requested name is valid, but no data of the requested type was found.

Remarks

Namespace providers are encouraged, but not required, to store information that is specific to the namespace they support.

Requirements

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