LPNSPV2LOOKUPSERVICEEND funzione di callback (ws2spi.h)
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 |
|---|---|
| L'handle non è valido. | |
| 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 |