See Also
 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. |
This section lists the upcalls that service providers may make into the Windows Sockets client. Service providers receive an upcall dispatch table as a parameter to WSPStartup, and use entries in this table to make the upcalls. Therefore, a client does not need to export its WPU functions.
It is not mandatory that providers use all of these upcalls. The following table indicates which upcalls must be used and which are optional.
| Function | Description | Status | Significance |
|---|---|---|---|
|
Closes an open event object handle. |
Optional. |
The provider may use an appropriate OS call instead. |
|
|
Closes a socket handle allocated by the Windows Sockets DLL. |
Required. |
Ws2.dll needs to query and/or modify internal state information associated with the socket handle. |
|
|
Creates a new event object. |
Optional. |
The provider may use an appropriate OS call instead. |
|
|
Creates a new socket handle for non-IFS providers. |
Required for non-IFS providers. |
Ws2.dll needs to query and/or modify internal state information associated with the socket handle. |
|
|
Checks the membership of the specified socket handle. |
Optional. |
This is just a convenience function that knows how to dig through FD SETstructures. A provider may need to dig through these structures explicitly anyway. |
|
|
Retrieves a socket's context value (non-IFS providers only). |
Required for non-IFS providers. |
Ws2.dll needs to query and/or modify internal state information associated with the socket handle. |
|
|
Resets an event object. |
Optional. |
The provider may use an appropriate OS call instead. |
|
|
Sets an event object. |
Optional. |
The provider may use an appropriate OS call instead. |