GetAddrInfoExCancel, fonction (ws2tcpip.h)
La fonction GetAddrInfoExCancel annule une opération asynchrone de la fonction GetAddrInfoEx .
Syntaxe
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
Paramètres
[in] lpHandle
Handle de l’opération asynchrone à annuler. Il s’agit du handle retourné dans le paramètre lpNameHandle par la fonction GetAddrInfoEx .
Valeur retournée
En cas de réussite, GetAddrInfoExCancel retourne NO_ERROR (0). L’échec retourne un code d’erreur Windows Sockets différent de zéro, comme indiqué dans les codes d’erreur des sockets Windows.
Remarques
La fonction GetAddrInfoExCancel annule une opération GetAddrInfoEx asynchrone. Le résultat est que le mécanisme d’achèvement de l’utilisateur, soit un rappel, soit un événement, soit est immédiatement appelé. Aucun résultat n’est retourné et le code d’erreur retourné pour l’opération asynchrone GetAddrInfoEx est défini sur WSA_E_CANCELLED. Si la requête GetAddrInfoEx est déjà terminée ou a expiré, ou si le handle n’est pas valide et WSA_INVALID_HANDLE sera retourné par la fonction GetAddrInfoExCancel .
Étant donné que la plupart des opérations sous-jacentes (par exemple, les fournisseurs de services de noms hérités) sont synchrones, ces opérations ne seront pas annulées. Ces opérations continueront à s’exécuter et à consommer des ressources. Une fois la dernière demande de fournisseur de services de nom en suspens terminée, les ressources sont publiées.
Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8.1, Windows 8 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | ws2tcpip.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |