LPNSPV2LOOKUPSERVICEEND função de retorno de chamada (ws2spi.h)
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 |
|---|---|
| O identificador não é válido. | |
| 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 |