функция обратного вызова 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.
| Код ошибки | Значение |
|---|---|
| Недостаточно памяти для выполнения этой операции. | |
| Вызывающая подпрограмма не имеет достаточных привилегий для установки службы. | |
| Один или несколько параметров были недопустимыми или отсутствующими для этого поставщика. | |
| Операция не поддерживается. Эта ошибка возвращается, если поставщик пространства имен не реализует эту функцию. Эта ошибка также может быть возвращена, если указанная команда dwControlCode является нераспознанной. | |
| Служба неизвестна. Служба не найдена в указанном пространстве имен. |
Комментарии
Функция 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 |