Compartilhar via


estrutura ICMP_ECHO_REPLY (ipexport.h)

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)

Confira também

GetIpErrorString

Página Inicial do Auxiliar de IP

Estruturas auxiliares de IP

Ipaddr

IP_OPTION_INFORMATION

IP_OPTION_INFORMATION32

IcmpCloseHandle

Icmpcreatefile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex