Funzione GetAddrInfoExCancel (ws2tcpip.h)
La funzione GetAddrInfoExCancel annulla un'operazione asincrona dalla funzione GetAddrInfoEx .
Sintassi
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
Parametri
[in] lpHandle
Handle dell'operazione asincrona da annullare. Questo è l'handle restituito nel parametro lpNameHandle dalla funzione GetAddrInfoEx .
Valore restituito
In caso di esito positivo, GetAddrInfoExCancel restituisce NO_ERROR (0). L'errore restituisce un codice di errore Windows Sockets diverso da zero, come indicato nei codici di errore di Windows Sockets.
Commenti
La funzione GetAddrInfoExCancel annulla un'operazione GetAddrInfoEx asincrona. Il risultato è che il meccanismo di completamento dell'utente, un callback o un evento, viene richiamato immediatamente. Non vengono restituiti risultati e il codice di errore restituito per l'operazione asincrona GetAddrInfoEx è impostato su WSA_E_CANCELLED. Se la richiesta GetAddrInfoEx è già stata completata o scaduta oppure l'handle non è valido e WSA_INVALID_HANDLE verrà restituita dalla funzione GetAddrInfoExCancel .
Poiché molte delle operazioni sottostanti (provider di servizi di nome legacy, ad esempio) sono sincrone, queste operazioni non verranno effettivamente annullate. Queste operazioni continueranno a eseguire e usare le risorse. Una volta completata l'ultima richiesta del provider di servizi nome in sospeso, le risorse verranno rilasciate.
Windows 8.1 e Windows Server 2012 R2: questa funzione è supportata per le app di Windows Store in Windows 8.1, Windows Server 2012 R2 e versioni successive.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1, Windows 8 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | ws2tcpip.h |
| Libreria | Ws2_32.lib |
| DLL | Ws2_32.dll |