LPNSPV2CLIENTSESSIONRUNDOWN función de devolución de llamada (ws2spi.h)
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 |
|---|---|
| No hay suficiente memoria disponible para realizar esta operación. | |
| La rutina de llamada no tiene privilegios suficientes para instalar el servicio. | |
| Uno o varios parámetros no eran válidos o faltaban para este proveedor. | |
| 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. | |
| 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 |