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 |
|---|---|
| El identificador no es válido. | |
| 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 |