estructura ICMPV6_ECHO_REPLY_LH (ipexport.h)

Artículo
08/24/2023

La estructura ICMPV6_ECHO_REPLY describe los datos devueltos en respuesta a una solicitud de eco IPv6.

Sintaxis

typedef struct icmpv6_echo_reply_lh {
  IPV6_ADDRESS_EX Address;
  ULONG           Status;
  unsigned int    RoundTripTime;
} ICMPV6_ECHO_REPLY_LH, *PICMPV6_ECHO_REPLY_LH;

Members

Address

Tipo: IPV6_ADDRESS_EX

Dirección IPv6 de respuesta, en forma de estructura IPV6_ADDRESS_EX .

Status

Tipo: ULONG

Estado de la solicitud de eco, en forma de código IP_STATUS . Los valores posibles para este miembro se definen en el archivo de encabezado Ipexport.h .

Valor	Significado
IP_SUCCESS 0	El estado se realizó correctamente.
IP_BUF_TOO_SMALL 11001	El búfer de respuesta era demasiado pequeño.
IP_DEST_NET_UNREACHABLE 11002	No se pudo acceder a la red de destino. En la terminología de IPv6, este valor de estado también se define como IP_DEST_NO_ROUTE.
IP_DEST_HOST_UNREACHABLE 11003	No se pudo acceder al host de destino. En la terminología de IPv6, este valor de estado también se define como IP_DEST_ADDR_UNREACHABLE.
IP_DEST_PROT_UNREACHABLE 11004	No se pudo acceder al protocolo de destino. En la terminología de IPv6, este valor de estado también se define como IP_DEST_PROHIBITED.
IP_DEST_PORT_UNREACHABLE 11005	No se pudo acceder al puerto de destino.
IP_NO_RESOURCES 11006	No había suficientes recursos de IP disponibles.
IP_BAD_OPTION 11007	Se especificó una opción ip incorrecta.
IP_HW_ERROR 11008	Error de hardware.
IP_PACKET_TOO_BIG 11009	El paquete era demasiado grande.
IP_REQ_TIMED_OUT 11010	Se ha agotado el tiempo de espera de la solicitud.
IP_BAD_REQ 11011	Una solicitud incorrecta.
IP_BAD_ROUTE 11012	Una ruta incorrecta.
IP_TTL_EXPIRED_TRANSIT 11013	El límite de salto para IPv6 expiró en tránsito. En la terminología de IPv6, este valor de estado también se define como IP_HOP_LIMIT_EXCEEDED.
IP_TTL_EXPIRED_REASSEM 11014	El límite de salto para IPv6 expiró durante la reensamblaje de fragmentos. En la terminología de IPv6, este valor de estado también se define como IP_REASSEMBLY_TIME_EXCEEDED.
IP_PARAM_PROBLEM 11015	Un problema de parámetros. En la terminología de IPv6, este valor de estado también se define como IP_PARAMETER_PROBLEM.
IP_SOURCE_QUENCH 11016	Los datagramas llegan demasiado rápidos para procesarse y es posible que se hayan descartado los datagramas.
IP_OPTION_TOO_BIG 11017	Una opción de IP era demasiado grande.
IP_BAD_DESTINATION 11018	Un destino incorrecto.
IP_DEST_UNREACHABLE 11040	No se pudo acceder al destino.
IP_TIME_EXCEEDED 11041	Se superó el tiempo.
IP_BAD_HEADER 11042	Se encontró un encabezado IP incorrecto.
IP_UNRECOGNIZED_NEXT_HEADER 11043	Se encontró un encabezado siguiente no reconocido.
IP_ICMP_ERROR 11044	Error de ICMP.
IP_DEST_SCOPE_MISMATCH 11045	Error de coincidencia de identificador de ámbito de destino.
IP_GENERAL_FAILURE 11050	Un error general. Este error se puede devolver para algunos paquetes ICMP con formato incorrecto.

RoundTripTime

Tipo: unsigned int

Tiempo de ida y vuelta, en milisegundos.

Comentarios

La función Icmp6ParseReplies usa la estructura ICMPV6_ECHO_REPLY para devolver la respuesta a una solicitud de eco IPv6. Los datos de respuesta que contienen el cuerpo del mensaje de la respuesta ICMPV6 siguen la estructura de ICMPV6_ECHO_REPLY en memoria.

Para IPv6, algunos de los valores posibles para el miembro Status se especifican en RFC 2163. Para obtener más información, vea www.ietf.org/rfc/rfc2463.txt.

La función GetIpErrorString se puede usar para recuperar la cadena de error del asistente de IP para el código de error IP_STATUS en el miembro Status .

La estructura ICMPV6_ECHO_REPLY se define en archivos de encabezado públicos incluidos en el Kit de desarrollo de software (SDK) de Microsoft Windows, pero esta estructura la usa la función Icmp6ParseReplies en Windows XP y versiones posteriores.

En Windows SDK, la estructura de ICMPV6_ECHO_REPLY_LH se define al compilar una aplicación si la plataforma de destino es Windows XP y versiones posteriores (NTDDI_VERSION >= NTDDI_XP, _WIN32_WINNT >= 0x0501o WINVER >= 0x0501). La estructura ICMPV6_ECHO_REPLY_LH se escribe en la estructura ICMPV6_ECHO_REPLY . Al compilar una aplicación si la plataforma de destino no es Windows XP y versiones posteriores, la estructura de ICMPV6_ECHO_REPLY no está definida.

Esta estructura se define en el archivo de encabezado Ipexport.h que se incluye automáticamente en el archivo de encabezado Iphlpapi.h . El archivo de encabezado Ipexport.h nunca se debe usar directamente.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	ipexport.h (incluya Iphlpapi.h)