Поделиться через

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

  • Статья

Функция NSPCleanup прекращает использование определенного поставщика услуг пространства имен Сокетов Windows.

Синтаксис

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Параметры

[in] lpProviderId

Указатель на GUID поставщика пространства имен, который необходимо завершить.

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

Если ошибка не возникает, функция NSPCleanup возвращает значение NO_ERROR (ноль). В противном случае возвращается SOCKET_ERROR (–1), и поставщик должен задать соответствующий код ошибки с помощью WSASetLastError.

Код ошибки Значение
WSA_NOT_ENOUGH_MEMORY Недостаточно памяти для выполнения этой операции.
WSAEINVAL Параметр lpProviderId не указывает допустимый поставщик.
WSAEOPNOTSUPP Операция не поддерживается. Эта ошибка возвращается, если поставщик пространства имен не реализует эту функцию.

Комментарии

Функция NSPCleanup вызывается при завершении работы приложения с помощью поставщика службы пространства имен Сокетов Windows. Функция NSPCleanup отменяет регистрацию определенного поставщика пространства имен и позволяет поставщику транспортных служб освободить все выделенные ресурсы поставщика пространства имен.

Перед использованием поставщиков пространств имен необходимо успешно вызвать функцию NSPStartup . Допускается выполнить несколько вызовов NSPStartup . Однако для каждого вызова NSPStartup также должен быть выдан соответствующий вызов NSPCleanup . Только окончательная очистка NSPCleanup для поставщика услуг выполняет фактическую очистку; предыдущие вызовы уменьшают количество внутренних ссылок в поставщике услуг.

Эта функция не должна возвращать данные до тех пор, пока библиотека DLL поставщика службы пространства имен не будет выгружена из памяти.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header ws2spi.h

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