LPNSPV2LOOKUPSERVICEEND funzione di callback (ws2spi.h)

Articolo
03/04/2024

La funzione NSPv2LookupServiceEnd viene chiamata per liberare l'handle dopo le chiamate precedenti a NSPv2LookupServiceBegin e NSPv2LookupServiceNextEx.

Sintassi

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

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

Parametri

[in] hLookup

Handle ottenuto in precedenza da una chiamata a
NSPv2LookupServiceBegin.

Valore restituito

La funzione deve restituire NO_ERROR (zero) se la routine ha esito positivo. Deve restituire SOCKET_ERROR (ovvero 1) se la routine ha esito negativo e deve impostare il codice di errore appropriato usando WSASetLastError.

Codice di errore	Significato
WSA_INVALID_HANDLE	L'handle non è valido.
WSA_NOT_ENOUGH_MEMORY	Memoria insufficiente per eseguire questa operazione.

Commenti

La funzione NSPv2LookupServiceEnd viene usata come parte dell'architettura del provider di servizi dello spazio dei nomi versione 2 (NSPv2) disponibile in Windows Vista e versioni successive.

In Windows Vista e Windows Server 2008 la funzione NSPv2LookupServiceEnd può essere usata solo per le operazioni sui provider di spazi dei nomi NS_EMAIL.

È possibile ricevere una chiamata di funzione NSPv2LookupServiceBegin su un altro thread durante l'elaborazione di un NSPv2LookupServiceNextEx. Ciò indica che il client ha annullato la richiesta e che il provider deve chiudere l'handle e restituire anche dalla chiamata di funzione NSPv2LookupServiceNextEx , impostando l'ultimo errore su WSA_E_CANCELLED.

In Windows Sockets 2 i codici di errore in conflitto sono definiti per WSAECANCELLED e WSA_E_CANCELLED. Il codice di errore WSAECANCELLED verrà rimosso in una versione futura e rimarrà solo WSA_E_CANCELLED. I provider di spazi dei nomi devono usare il codice di errore WSA_E_CANCELLED per mantenere la compatibilità con la gamma più ampia possibile di applicazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ws2spi.h