LPNSPLOOKUPSERVICEEND-Rückruffunktion (ws2spi.h)

  • Artikel

Die NSPLookupServiceEnd-Funktion wird aufgerufen, um das Handle nach vorherigen Aufrufen von NSPLookupServiceBegin und NSPLookupServiceNext frei zu geben.

Es ist möglich, einen NSPLookupServiceEnd-Aufruf für einen anderen Thread zu empfangen, während ein NSPLookupServiceNext verarbeitet wird. Dies gibt an, dass der Client die Anforderung abgebrochen hat und der Anbieter das Handle schließen und auch vom NSPLookupServiceNext-Aufruf zurückgeben sollte, wobei der letzte Fehler auf WSA_E_CANCELLED festgelegt wird.

Syntax

LPNSPLOOKUPSERVICEEND Lpnsplookupserviceend;

INT Lpnsplookupserviceend(
  [in] HANDLE hLookup
)
{...}

Parameter

[in] hLookup

Das Handle, das zuvor durch einen Aufruf von abgerufen wurde
NSPLookupServiceBegin.

Rückgabewert

Die Funktion sollte NO_ERROR (null) zurückgeben, wenn die Routine erfolgreich ist. Es sollte SOCKET_ERROR (–1) zurückgeben, wenn bei der Routine ein Fehler auftritt und der entsprechende Fehlercode mithilfe von WSASetLastError festgelegt werden muss.

Fehlercode Bedeutung
WSA_INVALID_HANDLE
 Das Handle ist ungültig.
WSA_NOT_ENOUGH_MEMORY
 Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
WSAEOPNOTSUPP
 Der Vorgang wird nicht unterstützt. Dieser Fehler wird zurückgegeben, wenn der Namespaceanbieter diese Funktion nicht implementiert.

Hinweise

In Windows Sockets 2 werden konfliktierende Fehlercodes für WSAECANCELLED und WSA_E_CANCELLED definiert. Der Fehlercode WSAECANCELLED wird in einer zukünftigen Version entfernt, und nur WSA_E_CANCELLED bleiben erhalten. Namespaceanbieter sollten den WSA_E_CANCELLED Fehlercode verwenden, um die Kompatibilität mit möglichst vielen Anwendungen zu gewährleisten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ws2spi.h

Weitere Informationen

NSPLookupServiceBegin

NSPLookupServiceWeiter

NSP_ROUTINE

WSASetLastError