Función de devolución de llamada LPNSPCLEANUP (ws2spi.h)

  • Artículo

La función NSPCleanup finaliza el uso de un proveedor de servicios de espacio de nombres de Windows Sockets determinado.

Sintaxis

LPNSPCLEANUP Lpnspcleanup;

INT Lpnspcleanup(
  [in] LPGUID lpProviderId
)
{...}

Parámetros

[in] lpProviderId

Puntero al GUID del proveedor de espacio de nombres que se va a finalizar.

Valor devuelto

Si no se produce ningún error, NSPCleanup devuelve un valor de NO_ERROR (cero). De lo contrario, se devuelve SOCKET_ERROR (–1) y el proveedor 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.
WSAEINVAL El parámetro lpProviderId no especifica un proveedor válido.
WSAEOPNOTSUPP La operación no es compatible. Este error se devuelve si el proveedor de espacios de nombres no implementa esta función.

Comentarios

Se llama a la función NSPCleanup cuando una aplicación termina de usar un proveedor de servicios de espacio de nombres de Windows Sockets. La función NSPCleanup registra un proveedor de espacios de nombres determinado y permite que el proveedor de servicios de transporte libere cualquiera de los recursos asignados del proveedor de espacios de nombres.

Se debe llamar correctamente a la función NSPStartup antes de usar cualquier proveedor de espacios de nombres. Se permite realizar más de una llamada de NSPStartup . Sin embargo, para cada llamada NSPStartup , también se debe emitir una llamada NSPCleanup correspondiente. Solo el NSPCleanup 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.

Esta función no debe devolverse hasta que el archivo DLL del proveedor de servicios de espacio de nombres se pueda descargar de la memoria.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ws2spi.h

Consulte también