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


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

Функция 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
Служба неизвестна. Служба не найдена в указанном пространстве имен.

Комментарии

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

В Windows Vista и Windows Server 2008 функцию NSPv2ClientSessionRundown можно использовать только для операций с поставщиками NS_EMAIL пространств имен.

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

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

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

Требования

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

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

NSPV2_ROUTINE

NSPv2Cleanup

NSPv2LookupServiceBegin

NSPv2LookupServiceEnd

NSPv2LookupServiceNextEx

NSPv2SetServiceEx

NSPv2Startup

WSAQUERYSET2

WSASetLastError