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

Статья
08/28/2023

Функция NSPv2ClientSessionRundown уведомляет поставщика службы пространства имен версии 2 (NSPv2) о том, что сеанс клиента завершается.

Синтаксис

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

void Lpnspv2clientsessionrundown(
  [in] LPGUID lpProviderId,
  [in] LPVOID pvClientSessionArg
)
{...}

Параметры

[in] lpProviderId

Указатель на GUID конкретного поставщика пространства имен для уведомления.

[in] pvClientSessionArg

Указатель на завершающийся сеанс клиента.

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

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

Код ошибки	Значение
WSA_NOT_ENOUGH_MEMORY	Недостаточно памяти для выполнения этой операции.
WSAEACCES	Вызывающая подпрограмма не имеет достаточных привилегий для установки службы.
WSAEINVAL	Один или несколько параметров были недопустимыми или отсутствующими для этого поставщика.
WSAEOPNOTSUPP	Операция не поддерживается. Эта ошибка возвращается, если поставщик пространства имен не реализует эту функцию. Эта ошибка также может быть возвращена, если указанная команда dwControlCode является нераспознанной.
WSASERVICE_NOT_FOUND	Служба неизвестна. Служба не найдена в указанном пространстве имен.

Функция NSPv2Startup вызывается при каждом запуске нового клиентского процесса с использованием поставщика пространства имен. Поставщики могут использовать аргумент сеанса клиента, на который указывает параметр ppvClientSessionArg , для хранения сведений об этом сеансе. Если в вызове функции NSPv2Startup было указано значение для аргумента сеанса клиента, этот же аргумент сеанса клиента передается в параметре pvClientSessionArg в функцию NSPv2ClientSessionRundown .

Функции NSPv2Startup, NSPv2ClientSessionRundown и NSPv2Cleanup являются необязательными в зависимости от требований поставщика NSPv2.

Если функция NSPv2ClientSessionRundown не реализована, вызовы этой функции должны быть перехвачены функцией-заглушкой, которая возвращает WSAEOPNOTSUPP. Указатель функции NSPv2 на нереализованную функцию NSPv2ClientSessionRundown в структуре NSPV2_ROUTINE должен указывать на функцию-заглушку.

Требования


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