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

Artículo
03/04/2024

La función NSPv2Startup notifica a un proveedor de servicios de espacio de nombres versión 2 (NSPv2) que un nuevo proceso de cliente consiste en empezar a usar el proveedor.

Sintaxis

LPNSPV2STARTUP Lpnspv2startup;

INT Lpnspv2startup(
  [in] LPGUID lpProviderId,
  [in] LPVOID *ppvClientSessionArg
)
{...}

Parámetros

[in] lpProviderId

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

[in] ppvClientSessionArg

Puntero a la sesión de cliente.

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 inicializar 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.
WSASERVICE_NOT_FOUND	El servicio es desconocido. El servicio no se encuentra en el espacio de nombres especificado.

Comentarios

La función NSPv2Startup 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 NSPv2Startup solo se puede usar para las operaciones en proveedores de espacios de nombres NS_EMAIL.

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. El valor del parámetro ppvClientSessionArg se pasará a las llamadas de función NSPv2 posteriores en la misma sesión. El argumento de sesión de cliente puede ser NULL, si el proveedor de espacios de nombres no requiere esta información.

Se llama a la función NSPv2Startup cuando se inicializa una nueva sesión de cliente. Las funciones NSPv2Startup y NSPv2Cleanup deben llamarse como pares.

Se debe llamar correctamente a la función NSPv2Startup antes de llamar a la función NSPv2Cleanup . Se permite realizar más de una llamada NSPv2Startup . Sin embargo, para cada llamada NSPv2Startup , también se debe emitir una llamada NSPv2Cleanup correspondiente. Solo el NSPv2Cleanup final para el proveedor de servicios realiza la limpieza real; el anterior llama a decrementar un recuento de referencias interno en el proveedor de servicios de espacio de nombres.

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

Si no se implementa la función NSPv2Startup , 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 NSPv2Startup no implementada en la estructura NSPV2_ROUTINE debe apuntar a la función de código auxiliar.

Requisitos

Requisito	Value
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