функция обратного вызова LPNSPV2LOOKUPSERVICEEND (ws2spi.h)

Статья
03/13/2024

Функция NSPv2LookupServiceEnd вызывается для освобождения дескриптора после предыдущих вызовов NSPv2LookupServiceBegin и NSPv2LookupServiceNextEx.

Синтаксис

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

Параметры

[in] hLookup

Дескриптор, полученный ранее при вызове
NSPv2LookupServiceBegin.

Возвращаемое значение

Функция должна возвращать NO_ERROR (ноль), если подпрограмма завершается успешно. Он должен вернуть SOCKET_ERROR (т. е. 1), если подпрограмма завершается сбоем, и она должна задать соответствующий код ошибки с помощью WSASetLastError.

Код ошибки	Значение
WSA_INVALID_HANDLE	Недопустимый дескриптор.
WSA_NOT_ENOUGH_MEMORY	Недостаточно памяти для выполнения этой операции.

Вызов функции 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