LPNSPV2LOOKUPSERVICEEND função de retorno de chamada (ws2spi.h)

Artigo
03/13/2024

A função NSPv2LookupServiceEnd é chamada para liberar o identificador após chamadas anteriores para NSPv2LookupServiceBegin e NSPv2LookupServiceNextEx.

Sintaxe

LPNSPV2LOOKUPSERVICEEND Lpnspv2lookupserviceend;

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

Parâmetros

[in] hLookup

O identificador obtido anteriormente por uma chamada para
NSPv2LookupServiceBegin.

Retornar valor

A função deverá retornar NO_ERROR (zero) se a rotina for bem-sucedida. Ele deverá retornar SOCKET_ERROR (ou seja, 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.

Comentários

A função NSPv2LookupServiceEnd é usada como parte da arquitetura do provedor de serviços de namespace versão 2 (NSPv2) disponível no Windows Vista e posterior.

No Windows Vista e no Windows Server 2008, a função NSPv2LookupServiceEnd só pode ser usada para operações em provedores de namespace NS_EMAIL.

É possível receber uma chamada de função NSPv2LookupServiceBegin em outro thread enquanto processa um NSPv2LookupServiceNextEx. Isso indica que o cliente cancelou a solicitação e o provedor deve fechar o identificador e retornar da chamada de função NSPv2LookupServiceNextEx também, definindo o último erro como WSA_E_CANCELLED.

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 o maior intervalo possível de aplicativos.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ws2spi.h