A name service query involves a series of calls: NSPLookupServiceBegin, followed by one or more calls to NSPLookupServiceNextand ending with a call to NSPLookupServiceEnd. NSPLookupServiceBegintakes a WSAQUERYSETstructure as input in order to define the query parameters along with a set of flags to provide additional control over the search operation. It returns a query handle that is used in the subsequent calls to NSPLookupServiceNextand NSPLookupServiceEnd.

The namespace SPI client invokes NSPLookupServiceNextto obtain query results, with results supplied in a client-supplied WSAQUERYSETbuffer. The client continues to call NSPLookupServiceNextuntil the error code WSA_E_NO_MORE is returned indicating that all results have been retrieved. The search is then terminated by a call to NSPLookupServiceEnd. The NSPLookupServiceEndfunction can also be used to cancel a currently pending NSPLookupServiceNextwhen called from another thread.

In Winsock, conflicting error codes are defined for WSAENOMORE (10102) and WSA_E_NO_MORE (10110). The error code WSAENOMORE will be removed in a future version and only WSA_E_NO_MORE will remain. Namespace providers should switch to using the WSA_E_NO_MORE error code as soon as possible to maintain compatibility with the widest possible range of applications.

See Also