estrutura ICMPV6_ECHO_REPLY_LH (ipexport.h)

Artigo
08/24/2023

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)