Функция GetAddrInfoExCancel (ws2tcpip.h)
Функция GetAddrInfoExCancel отменяет асинхронную операцию с помощью функции GetAddrInfoEx .
Синтаксис
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
Параметры
[in] lpHandle
Дескриптор отменяемой асинхронной операции. Это дескриптор, возвращаемый в параметре lpNameHandle функцией GetAddrInfoEx .
Возвращаемое значение
При успешном выполнении GetAddrInfoExCancel возвращает NO_ERROR (0). Сбой возвращает ненулевой код ошибки Сокеты Windows, как указано в разделе Коды ошибок сокетов Windows.
Комментарии
Функция GetAddrInfoExCancel отменяет асинхронную операцию GetAddrInfoEx . В результате механизм завершения пользователя( обратный вызов или событие) вызывается немедленно. Результаты не возвращаются, а код ошибки, возвращаемый для асинхронной операции GetAddrInfoEx , имеет значение WSA_E_CANCELLED. Если запрос GetAddrInfoEx уже завершен или истекло время ожидания или дескриптор недопустим, а WSA_INVALID_HANDLE будет возвращена функцией GetAddrInfoExCancel .
Поскольку многие базовые операции (например, устаревшие поставщики служб имен) являются синхронными, эти операции фактически не будут отменены. Эти операции будут продолжать выполняться и потреблять ресурсы. После завершения запроса поставщика услуг с именем последнего имени ресурсы будут освобождены.
Windows 8.1 и Windows Server 2012 R2. Эта функция поддерживается для приложений Магазина Windows на Windows 8.1, Windows Server 2012 R2 и более поздних версиях.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8.1, Windows 8 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | ws2tcpip.h |
| Библиотека | Ws2_32.lib |
| DLL | Ws2_32.dll |