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

Voir aussi

GetAddrInfoEx