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

Artículo
03/04/2024

Se llama a la función NSPv2LookupServiceEnd para liberar el identificador después de las llamadas anteriores a NSPv2LookupServiceBegin y NSPv2LookupServiceNextEx.

Sintaxis

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

INT Lpnspv2lookupserviceend(
  [in] HANDLE hLookup
)
{...}

Parámetros

[in] hLookup

Identificador obtenido anteriormente mediante una llamada a
NSPv2LookupServiceBegin.

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_INVALID_HANDLE	El identificador no es válido.
WSA_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible para realizar esta operación.

Comentarios

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

Es posible recibir una llamada de función NSPv2LookupServiceBegin en otro subproceso mientras se procesa un NSPv2LookupServiceNextEx. Esto indica que el cliente ha cancelado la solicitud y el proveedor debe cerrar el identificador y volver desde la llamada de función NSPv2LookupServiceNextEx , estableciendo también el último error en WSA_E_CANCELLED.

En Windows Sockets 2, los códigos de error en conflicto se definen para WSAECANCELLED y WSA_E_CANCELLED. El código de error WSAECANCELLED se quitará en una versión futura y solo permanecerá WSA_E_CANCELLED. Los proveedores de espacios de nombres deben usar el código de error WSA_E_CANCELLED para mantener la compatibilidad con la gama de aplicaciones más amplia posible.

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