Função GetAddrInfoExCancel (ws2tcpip.h)
A função GetAddrInfoExCancel cancela uma operação assíncrona pela função GetAddrInfoEx .
Sintaxe
INT WSAAPI GetAddrInfoExCancel(
[in] LPHANDLE lpHandle
);
Parâmetros
[in] lpHandle
O identificador da operação assíncrona a ser cancelada. Esse é o identificador retornado no parâmetro lpNameHandle pela função GetAddrInfoEx .
Retornar valor
Com êxito, GetAddrInfoExCancel retorna NO_ERROR (0). Falha retorna um código de erro diferente de zero do Windows Sockets, conforme encontrado nos Códigos de Erro do Windows Sockets.
Comentários
A função GetAddrInfoExCancel cancela uma operação GetAddrInfoEx assíncrona. O resultado é que o mecanismo de conclusão do usuário, um retorno de chamada ou um evento, é imediatamente invocado. Nenhum resultado é retornado e o código de erro retornado para a operação assíncrona GetAddrInfoEx é definido como WSA_E_CANCELLED. Se a solicitação GetAddrInfoEx já tiver sido concluída ou atingiu o tempo limite ou o identificador for inválido e WSA_INVALID_HANDLE será retornado pela função GetAddrInfoExCancel .
Como muitas das operações subjacentes (provedores de serviços de nome herdado, por exemplo) são síncronas, essas operações não serão realmente canceladas. Essas operações continuarão executando e consumindo recursos. Depois que a solicitação do provedor de serviços de nome pendente for concluída, os recursos serão liberados.
Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8.1, Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | ws2tcpip.h |
| Biblioteca | Ws2_32.lib |
| DLL | Ws2_32.dll |