LPNSPV2LOOKUPSERVICEEND Rückruffunktion (ws2spi.h)

Artikel
03/04/2024

Die NSPv2LookupServiceEnd-Funktion wird aufgerufen, um das Handle nach vorherigen Aufrufen von NSPv2LookupServiceBegin und NSPv2LookupServiceNextEx frei zu geben.

Syntax

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

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

Parameter

[in] hLookup

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

Rückgabewert

Die Funktion sollte NO_ERROR (null) zurückgeben, wenn die Routine erfolgreich ist. Es sollte SOCKET_ERROR (d. h. 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.

Hinweise

Die NSPv2LookupServiceEnd-Funktion wird als Teil der NSPv2-Architektur (Namespace Service Provider Version-2) verwendet, die unter Windows Vista und höher verfügbar ist.

Unter Windows Vista und Windows Server 2008 kann die NSPv2LookupServiceEnd-Funktion nur für Vorgänge auf NS_EMAIL Namespaceanbietern verwendet werden.

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

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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ws2spi.h