Функция 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 и более поздних версиях.

Требования

См. также раздел

GetAddrInfoEx