LPNSPV2CLIENTSESSIONRUNDOWN función de devolución de llamada (ws2spi.h)

Artículo
08/28/2023

La función NSPv2ClientSessionRundown notifica a un proveedor de servicios de espacio de nombres versión 2 (NSPv2) que finaliza la sesión del cliente.

Sintaxis

LPNSPV2CLIENTSESSIONRUNDOWN Lpnspv2clientsessionrundown;

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

Parámetros

[in] lpProviderId

Puntero al GUID del proveedor de espacio de nombres específico que se va a notificar.

[in] pvClientSessionArg

Puntero a la sesión de cliente que termina.

Valor devuelto

La función debe devolver NO_ERROR (cero) si la rutina se realiza correctamente. Debe devolver SOCKET_ERROR (es decir, 1) si se produce un error en la rutina y debe establecer el código de error adecuado mediante WSASetLastError.

Código de error	Significado
WSA_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible para realizar esta operación.
WSAEACCES	La rutina de llamada no tiene privilegios suficientes para instalar el servicio.
WSAEINVAL	Uno o varios parámetros no eran válidos o faltaban para este proveedor.
WSAEOPNOTSUPP	La operación no es compatible. Este error se devuelve si el proveedor de espacios de nombres no implementa esta función. Este error también se puede devolver si dwControlCode especificado es un comando no reconocido.
WSASERVICE_NOT_FOUND	El servicio es desconocido. El servicio no se encuentra en el espacio de nombres especificado.

Observaciones

La función NSPv2ClientSessionRundown se usa como parte de la arquitectura del proveedor de servicios de espacio de nombres versión 2 (NSPv2) disponible en Windows Vista y versiones posteriores.

En Windows Vista y Windows Server 2008, la función NSPv2ClientSessionRundown solo se puede usar para las operaciones en NS_EMAIL proveedores de espacios de nombres.

La función NSPv2Startup se llama cada vez que un nuevo proceso de cliente comienza a usar el proveedor de espacios de nombres. Los proveedores pueden usar el argumento de sesión de cliente al que apunta el parámetro ppvClientSessionArg para almacenar información sobre esta sesión. Si se especificó un valor para el argumento de sesión de cliente en la llamada a la función NSPv2Startup , este mismo argumento de sesión de cliente se pasa en el parámetro pvClientSessionArg a la función NSPv2ClientSessionRundown .

Las funciones NSPv2Startup, NSPv2ClientSessionRundown y NSPv2Cleanup son opcionales, dependiendo de los requisitos del proveedor NSPv2.

Si no se implementa la función NSPv2ClientSessionRundown , las llamadas a esa función deben interceptarse mediante una función de código auxiliar que devuelve WSAEOPNOTSUPP. El puntero de función NSPv2 a la función NSPv2ClientSessionRundown no implementada en la estructura NSPV2_ROUTINE debe apuntar a la función de código auxiliar.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	ws2spi.h