LPNSPINSTALLSERVICECLASS callback function (ws2spi.h)
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 |
|---|---|
| The namespace provider cannot supply the requested class information. | |
| There is not enough memory available to perform this operation. | |
| The calling routine does not have sufficient privileges to perform this operation. | |
| 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. | |
| The service class identifier was invalid or improperly structured. This error is returned if the lpServiceClassInfo parameter is **NULL**. | |
| The operation is not supported. This error is returned if the namespace provider does not implement this function. | |
| 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 |