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

Vedi anche

GetAddrInfoEx