Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves all the pertinent class information (schema) pertaining to the name-space provider. It retrieves any name space-specific information that is common to all instances of the service, including connection information for SAP, or port information for SAP or TCP.

Syntax 

int NSPGetServiceClassInfo(
  LPGUID 
lpProviderId,
  LPDWORD
 lpdwBufSize,
  LPWSASERVICECLASSINFOW 
lpServiceClassInfo 
);

Parameters

lpProviderId

[in] Pointer to the GUID of the specific name space provider from which the service class schema is to be retrieved.

lpdwBufSize

[in] Number of bytes contained in the buffer pointed to by lpServiceClassInfoon input. Alternately, if the function fails and the error is WSAEFAULT, lpdwBufSizecontains the minimum number of bytes to pass for the lpServiceClassInfoto retrieve the record on output.

lpServiceClassInfo

[in] Returns service class to name space-specific mapping information. The lpServiceClassIdparameter must be filled in to indicate which WSASERVICECLASSINFOWrecord should be returned.

Return Value

If no error occurs, NSPGetServiceClassreturns NO_ERROR (zero). Otherwise, the function returns SOCKET_ERROR (–1) and it must set the appropriate error code using the SetLastErrorfunction.

Note:
The default Name Service Provider (for DNS/WINS) in Windows Embedded CE does not support this function and will always return SOCKET_ERROR and set the error code to WSAEOPNOTSUPP.

Remarks

The W2_32.dll uses this function to retrieve the name space specific information passed into the NSPLookupServiceBeginand NSPSetService.

Requirements

Header ws2spi.h
Library Ws2.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also