Compartir a través de


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

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

Consulte también

NSPV2_ROUTINE

NSPv2Cleanup

NSPv2ClientSessionRundown

NSPv2LookupServiceBegin

NSPv2LookupServiceNextEx

NSPv2SetServiceEx

NSPv2Startup

WSAQUERYSET2

WSASetLastError