estrutura ICMP_ECHO_REPLY (ipexport.h)

Artigo
08/24/2023

A estrutura ICMP_ECHO_REPLY descreve os dados retornados em resposta a uma solicitação de eco IPv4.

Sintaxe

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;

Membros

Address

Tipo: IPAddr

O endereço IPv4 de resposta, na forma de uma estrutura IPAddr .

Status

Tipo: ULONG

O status da solicitação de eco, na forma de um código IP_STATUS. Os valores possíveis para esse membro são definidos no arquivo de cabeçalho Ipexport.h .

Valor	Significado
IP_SUCCESS 0	O status foi um sucesso.
IP_BUF_TOO_SMALL 11001	O buffer de resposta era muito pequeno.
IP_DEST_NET_UNREACHABLE 11002	A rede de destino era inacessível.
IP_DEST_HOST_UNREACHABLE 11003	O host de destino era inacessível.
IP_DEST_PROT_UNREACHABLE 11004	O protocolo de destino era inacessível.
IP_DEST_PORT_UNREACHABLE 11005	A porta de destino era inacessível.
IP_NO_RESOURCES 11006	Recursos de IP insuficientes estavam disponíveis.
IP_BAD_OPTION 11007	Uma opção de IP inválida foi especificada.
IP_HW_ERROR 11008	Ocorreu um erro de hardware.
IP_PACKET_TOO_BIG 11009	O pacote era muito grande.
IP_REQ_TIMED_OUT 11010	Tempo limite da solicitação excedido.
IP_BAD_REQ 11011	Uma solicitação inválida.
IP_BAD_ROUTE 11012	Uma rota ruim.
IP_TTL_EXPIRED_TRANSIT 11013	A TTL (vida útil) expirou em trânsito.
IP_TTL_EXPIRED_REASSEM 11014	O tempo de vida expirou durante a remontagem do fragmento.
IP_PARAM_PROBLEM 11015	Um problema de parâmetro.
IP_SOURCE_QUENCH 11016	Os datagramas estão chegando muito rápido para serem processados e os datagramas podem ter sido descartados.
IP_OPTION_TOO_BIG 11017	Uma opção de IP era muito grande.
IP_BAD_DESTINATION 11018	Um destino ruim.
IP_GENERAL_FAILURE 11050	Uma falha geral. Esse erro pode ser retornado para alguns pacotes ICMP malformados.

RoundTripTime

Tipo: ULONG

O tempo de ida e volta, em milissegundos.

DataSize

Tipo: USHORT

O tamanho dos dados, em bytes, da resposta.

Reserved

Tipo: USHORT

Reservado para uso do sistema.

Data

Tipo: PVOID

Um ponteiro para os dados de resposta.

Options

Tipo: struct ip_option_information

As opções de IP no cabeçalho IP da resposta, na forma de uma estrutura IP_OPTION_INFORMATION .

Comentários

A estrutura ICMP_ECHO_REPLY é usada pela função IcmpParseReplies para retornar a resposta a uma solicitação de eco IPv4. Em uma plataforma de 64 bits, a estrutura de ICMP_ECHO_REPLY32 deve ser usada.

Para IPv4, alguns dos valores possíveis para o membro Status são especificados no RFC 792.

A função GetIpErrorString pode ser usada para recuperar a cadeia de caracteres de erro auxiliar ip do código de erro IP_STATUS no membro Status .

A estrutura ICMP_ECHO_REPLY é definida no arquivo de cabeçalho Ipexport.h que é incluído automaticamente no arquivo de cabeçalho Iphlpapi.h . O arquivo de cabeçalho Ipexport.h nunca deve ser usado diretamente.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	ipexport.h (inclua Iphlpapi.h)