Função de retorno de chamada LPNSPLOOKUPSERVICEEND (ws2spi.h)
A função NSPLookupServiceEnd é chamada para liberar o identificador após chamadas anteriores para NSPLookupServiceBegin e NSPLookupServiceNext.
É possível receber uma chamada NSPLookupServiceEnd em outro thread enquanto processa um NSPLookupServiceNext. Isso indica que o cliente cancelou a solicitação e o provedor deve fechar o identificador e retornar da chamada NSPLookupServiceNext também, definindo o último erro como WSA_E_CANCELLED.
Sintaxe
LPNSPLOOKUPSERVICEEND Lpnsplookupserviceend;
INT Lpnsplookupserviceend(
[in] HANDLE hLookup
)
{...}
Parâmetros
[in] hLookup
O identificador obtido anteriormente por uma chamada para
NSPLookupServiceBegin.
Retornar valor
A função deverá retornar NO_ERROR (zero) se a rotina for bem-sucedida. Ele deverá retornar SOCKET_ERROR (–1) se a rotina falhar e precisar definir o código de erro apropriado usando WSASetLastError.
| Código do erro | Significado |
|---|---|
| O identificador não é válido. | |
| Não há memória suficiente disponível para executar essa operação. | |
| A operação não tem suporte. Esse erro será retornado se o provedor de namespace não implementar essa função. |
Comentários
No Windows Sockets 2, códigos de erro conflitantes são definidos para WSAECANCELLED e WSA_E_CANCELLED. O código de erro WSAECANCELLED será removido em uma versão futura e somente WSA_E_CANCELLED permanecerá. Os provedores de namespace devem usar o código de erro WSA_E_CANCELLED para manter a compatibilidade com a maior variedade possível de aplicativos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | ws2spi.h |