estructura ICMP_ECHO_REPLY (ipexport.h)

Artículo
08/24/2023

La estructura ICMP_ECHO_REPLY describe los datos devueltos en respuesta a una solicitud de eco IPv4.

Sintaxis

typedef struct icmp_echo_reply {
  IPAddr                       Address;
  ULONG                        Status;
  ULONG                        RoundTripTime;
  USHORT                       DataSize;
  USHORT                       Reserved;
  PVOID                        Data;
  struct ip_option_information Options;
} ICMP_ECHO_REPLY, *PICMP_ECHO_REPLY;

Members

Address

Tipo: IPAddr

Dirección IPv4 de respuesta, en forma de una estructura IPAddr .

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.
IP_DEST_HOST_UNREACHABLE 11003	No se pudo acceder al host de destino.
IP_DEST_PROT_UNREACHABLE 11004	No se pudo acceder al protocolo de destino.
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 período de vida (TTL) expiró en tránsito.
IP_TTL_EXPIRED_REASSEM 11014	El período de vida expirado durante la reensamblaje de fragmentos.
IP_PARAM_PROBLEM 11015	Un problema de parámetros.
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_GENERAL_FAILURE 11050	Un error general. Este error se puede devolver para algunos paquetes ICMP con formato incorrecto.

RoundTripTime

Tipo: ULONG

Tiempo de ida y vuelta, en milisegundos.

DataSize

Tipo: USHORT

Tamaño de los datos, en bytes, de la respuesta.

Reserved

Tipo: USHORT

Reservado para uso del sistema.

Data

Tipo: PVOID

Puntero a los datos de respuesta.

Options

Tipo: struct ip_option_information

Las opciones de IP en el encabezado IP de la respuesta, en forma de una estructura de IP_OPTION_INFORMATION .

Comentarios

La función IcmpParseReplies usa la estructura ICMP_ECHO_REPLY para devolver la respuesta a una solicitud de eco IPv4. En una plataforma de 64 bits, se debe usar la estructura ICMP_ECHO_REPLY32 .

Para IPv4, algunos de los valores posibles para el miembro Status se especifican en RFC 792.

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 ICMP_ECHO_REPLY 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 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	ipexport.h (incluya Iphlpapi.h)