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 is called to free the handle after previous calls to NSPLookupServiceBeginand NSPLookupServiceNext.

It is possible to receive an NSPLookupServiceEndcall 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 NSPLookupServiceNextcall as well, setting the last error to WSA_E_CANCELLED.

Syntax 

int NSPLookupServiceEnd(
  HANDLE
 hLookup
);

Parameters

hLookup

[in] Handle previously obtained by calling NSPLookupServiceBegin.

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

Error value Description

WSA_INVALID_HANDLE

Handle is not valid.

WSA_NOT_ENOUGH_MEMORY

Not enough free memory available to perform this operation.

Remarks

In Winsock, 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.

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