| Platform SDK: Windows Sockets |
The NSPLookupServiceEnd function is called to free the handle after previous calls to NSPLookupServiceBegin and NSPLookupServiceNext.
It is possible to receive an NSPLookupServiceEnd call on another thread while processing an NSPLookupServiceNext. This indicates that the client has canceled the request and the provider should close the handle and return from the NSPLookupServiceNext call as well, setting the last error to WSA_E_CANCELLED.
int NSPLookupServiceEnd ( HANDLE hLookup );
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.
In Windows Sockets 2, conflicting error codes are defined for WSAECANCELLED (10103) and WSA_E_CANCELLED (10111). The error code WSAECANCELLED will be removed in a future version and only WSA_E_CANCELLED will remain. Name Space Providers should switch to using the WSA_E_CANCELLED error code as soon as possible to maintain compatibility with the widest possible range of applications.
| Error code | Meaning |
|---|---|
| WSA_INVALID_HANDLE | Handle is not valid. |
| WSA_NOT_ENOUGH_MEMORY | Not enough free memory available to perform this operation. |
Version: Requires Windows Sockets 2.0.
Header: Declared in Ws2spi.h.