NSPStartup (Compact 2013)
3/26/2014
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 |