LPNSPLOOKUPSERVICEEND-Rückruffunktion (ws2spi.h)
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 |
|---|---|
| Das Handle ist ungültig. | |
| Für diesen Vorgang ist nicht genügend Arbeitsspeicher verfügbar. | |
| 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 |