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

Confira também

GetAddrInfoEx