функция обратного вызова LPNSPV2LOOKUPSERVICEEND (ws2spi.h)
Функция NSPv2LookupServiceEnd вызывается для освобождения дескриптора после предыдущих вызовов NSPv2LookupServiceBegin и NSPv2LookupServiceNextEx.
Синтаксис
LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;
INT Lpnspv2lookupserviceend(
[in] HANDLE hLookup
)
{...}
Параметры
[in] hLookup
Дескриптор, полученный ранее при вызове
NSPv2LookupServiceBegin.
Возвращаемое значение
Функция должна возвращать NO_ERROR (ноль), если подпрограмма завершается успешно. Он должен вернуть SOCKET_ERROR (т. е. 1), если подпрограмма завершается сбоем, и она должна задать соответствующий код ошибки с помощью WSASetLastError.
| Код ошибки | Значение |
|---|---|
| Недопустимый дескриптор. | |
| Недостаточно памяти для выполнения этой операции. |
Комментарии
Функция NSPv2LookupServiceEnd используется как часть архитектуры поставщика услуг пространства имен версии 2 (NSPv2), доступной в Windows Vista и более поздних версиях.
В Windows Vista и Windows Server 2008 функцию NSPv2LookupServiceEnd можно использовать только для операций с поставщиками NS_EMAIL пространств имен.
Вызов функции NSPv2LookupServiceBegin можно получить в другом потоке при обработке NSPv2LookupServiceNextEx. Это означает, что клиент отменил запрос, и поставщик должен закрыть дескриптор и вернуться из вызова функции NSPv2LookupServiceNextEx , установив для последней ошибки значение WSA_E_CANCELLED.
В windows Sockets 2 конфликтующие коды ошибок определяются для WSAECANCELLED и WSA_E_CANCELLED. Код ошибки WSAECANCELLED будет удален в следующей версии и останется только WSA_E_CANCELLED. Поставщики пространств имен должны использовать код ошибки WSA_E_CANCELLED для обеспечения совместимости с максимально широким спектром приложений.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | ws2spi.h |