Compartilhar via


estrutura ICMPV6_ECHO_REPLY_LH (ipexport.h)

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

Sintaxe

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

Membros

Address

Tipo: IPV6_ADDRESS_EX

O endereço IPv6 de resposta, na forma de uma estrutura IPV6_ADDRESS_EX .

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 sucesso.
IP_BUF_TOO_SMALL
11001
O buffer de resposta era muito pequeno.
IP_DEST_NET_UNREACHABLE
11002
A rede de destino estava inacessível. Na terminologia IPv6, esse valor de status também é definido como IP_DEST_NO_ROUTE.
IP_DEST_HOST_UNREACHABLE
11003
O host de destino estava inacessível. Na terminologia IPv6, esse valor de status também é definido como IP_DEST_ADDR_UNREACHABLE.
IP_DEST_PROT_UNREACHABLE
11004
O protocolo de destino estava inacessível. Na terminologia IPv6, esse valor de status também é definido como IP_DEST_PROHIBITED.
IP_DEST_PORT_UNREACHABLE
11005
A porta de destino estava 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 incorreta.
IP_BAD_ROUTE
11012
Uma rota ruim.
IP_TTL_EXPIRED_TRANSIT
11013
O limite de salto para IPv6 expirou em trânsito. Na terminologia IPv6, esse valor de status também é definido como IP_HOP_LIMIT_EXCEEDED.
IP_TTL_EXPIRED_REASSEM
11014
O limite de salto para IPv6 expirou durante a remontagem de fragmentos. Na terminologia IPv6, esse valor de status também é definido como IP_REASSEMBLY_TIME_EXCEEDED.
IP_PARAM_PROBLEM
11015
Um problema de parâmetro. Na terminologia IPv6, esse valor de status também é definido como IP_PARAMETER_PROBLEM.
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 inválido.
IP_DEST_UNREACHABLE
11040
O destino estava inacessível.
IP_TIME_EXCEEDED
11041
O tempo foi excedido.
IP_BAD_HEADER
11042
Um cabeçalho IP inválido foi encontrado.
IP_UNRECOGNIZED_NEXT_HEADER
11043
Um próximo cabeçalho não reconhecido foi encontrado.
IP_ICMP_ERROR
11044
Ocorreu um erro ICMP.
IP_DEST_SCOPE_MISMATCH
11045
Ocorreu uma incompatibilidade de ID de escopo de destino.
IP_GENERAL_FAILURE
11050
Uma falha geral. Esse erro pode ser retornado para alguns pacotes ICMP malformados.

RoundTripTime

Tipo: unsigned int

O tempo de ida e volta, em milissegundos.

Comentários

A estrutura ICMPV6_ECHO_REPLY é usada pela função Icmp6ParseReplies para retornar a resposta a uma solicitação de eco IPv6. Os dados de resposta que contêm o corpo da mensagem da resposta ICMPV6 seguem a estrutura ICMPV6_ECHO_REPLY na memória.

Para IPv6, alguns dos valores possíveis para o membro Status são especificados no RFC 2163. Para obter mais informações, consulte www.ietf.org/rfc/rfc2463.txt.

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 ICMPV6_ECHO_REPLY é definida em arquivos de cabeçalho público incluídos no SDK (Software Development Kit) do Microsoft Windows, mas essa estrutura é usada pela função Icmp6ParseReplies no Windows XP e posterior.

No SDK do Windows, a estrutura ICMPV6_ECHO_REPLY_LH é definida ao compilar um aplicativo se a plataforma de destino for Windows XP e posterior (NTDDI_VERSION >= NTDDI_XP, _WIN32_WINNT >= 0x0501ou WINVER >= 0x0501). A estrutura ICMPV6_ECHO_REPLY_LH é digitada para a estrutura ICMPV6_ECHO_REPLY . Ao compilar um aplicativo se a plataforma de destino não for Windows XP e posterior, a estrutura ICMPV6_ECHO_REPLY será indefinida.

Essa estrutura é 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 XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [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

IPV6_ADDRESS_EX

IP_OPTION_INFORMATION

Icmp6CreateFile

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCloseHandle