Função de retorno de chamada LPNSPLOOKUPSERVICEEND (ws2spi.h)

  • Artigo

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
WSA_INVALID_HANDLE
 O identificador não é válido.
WSA_NOT_ENOUGH_MEMORY
 Não há memória suficiente disponível para executar essa operação.
WSAEOPNOTSUPP
 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

Confira também

Nsplookupservicebegin

Nsplookupservicenext

NSP_ROUTINE

WSASetLastError