Función GetAddrInfoExCancel (ws2tcpip.h)

La función GetAddrInfoExCancel cancela una operación asincrónica mediante la función GetAddrInfoEx .

Sintaxis

INT WSAAPI GetAddrInfoExCancel(
  [in] LPHANDLE lpHandle
);

Parámetros

[in] lpHandle

Identificador de la operación asincrónica que se va a cancelar. Este es el identificador devuelto en el parámetro lpNameHandle por la función GetAddrInfoEx .

Valor devuelto

Si se ejecuta correctamente, GetAddrInfoExCancel devuelve NO_ERROR (0). Error devuelve un código de error de Windows Sockets distinto de cero, como se encuentra en los códigos de error de Windows Sockets.

Comentarios

La función GetAddrInfoExCancel cancela una operación GetAddrInfoEx asincrónica. El resultado es que el mecanismo de finalización del usuario, ya sea una devolución de llamada o un evento, se invoca inmediatamente. No se devuelven resultados y el código de error devuelto para la operación asincrónica GetAddrInfoEx se establece en WSA_E_CANCELLED. Si la solicitud GetAddrInfoEx ya se ha completado o ha agotado el tiempo de espera, o el identificador no es válido y la función GetAddrInfoExCancel devolverá WSA_INVALID_HANDLE.

Dado que muchas de las operaciones subyacentes (proveedores de servicios de nombres heredados, por ejemplo) son sincrónicas, estas operaciones no se cancelarán realmente. Estas operaciones seguirán ejecutándose y consumiendo recursos. Una vez completada la última solicitud del proveedor de servicios de nombre pendiente, se liberarán los recursos.

Windows 8.1 y Windows Server 2012 R2: esta función es compatible con las aplicaciones de la Tienda Windows en Windows 8.1, Windows Server 2012 R2 y versiones posteriores.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8.1, Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado ws2tcpip.h
Library Ws2_32.lib
Archivo DLL Ws2_32.dll

Consulte también

GetAddrInfoEx