NSPStartup (Windows Embedded CE 6.0)

1/6/2010

This function retrieves the dynamic information about a provider, such as the list of the DLL entry points.

This function is called by the client on initialization. NSPStartup and NSPCleanup must be called as pairs. All the NSP functions must be called from within an NSPStartup/NSPCleanup pair. WSC functions do not need to be called from within an NSPStartup/NSPCleanup pair.

Syntax

int NSPStartup(
  LPGUID lpProviderId,
  LPNSP_ROUTINE lpnspRoutines 
);

Parameters

  • lpProviderId
    [in] Indicates the desired provider for which to return the entry points.
  • lpnspRoutines
    [out] Pointer to all the provider entry points.

Data Types

This function call requires the data defined in the NSP_Routine structure. This structure contains information regarding all the functions implemented by a given provider.

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

The following table shows the possible error codes.

Value Description

WSAEINVAL

One or more parameters were invalid or missing for this provider.

WSA_NOT_ENOUGH_MEMORY

Not enough free memory available to perform this operation.

Requirements

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

See Also

Reference

Winsock SPI Functions
NSPCleanup
NSP_Routine