struttura ICMP_ECHO_REPLY (ipexport.h)

Articolo
08/24/2023

La struttura ICMP_ECHO_REPLY descrive i dati restituiti in risposta a una richiesta echo IPv4.

Sintassi

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

Indirizzo IPv4 di risposta, sotto forma di struttura IPAddr .

Status

Tipo: ULONG

Stato della richiesta echo, sotto forma di codice IP_STATUS . I valori possibili per questo membro sono definiti nel file di intestazione Ipexport.h .

Valore	Significato
IP_SUCCESS 0	Lo stato è riuscito.
IP_BUF_TOO_SMALL 11001	Il buffer di risposta era troppo piccolo.
IP_DEST_NET_UNREACHABLE 11002	La rete di destinazione non è raggiungibile.
IP_DEST_HOST_UNREACHABLE 11003	L'host di destinazione non è raggiungibile.
IP_DEST_PROT_UNREACHABLE 11004	Il protocollo di destinazione non è raggiungibile.
IP_DEST_PORT_UNREACHABLE 11005	La porta di destinazione non è raggiungibile.
IP_NO_RESOURCES 11006	Sono disponibili risorse IP insufficienti.
IP_BAD_OPTION 11007	È stata specificata un'opzione IP non valida.
IP_HW_ERROR 11008	Si è verificato un errore hardware.
IP_PACKET_TOO_BIG 11009	Il pacchetto era troppo grande.
IP_REQ_TIMED_OUT 11010	Timeout della richiesta.
IP_BAD_REQ 11011	Richiesta non valida.
IP_BAD_ROUTE 11012	Un percorso sbagliato.
IP_TTL_EXPIRED_TRANSIT 11013	Tempo di durata (TTL) scaduto in transito.
IP_TTL_EXPIRED_REASSEM 11014	Tempo di scadenza durante il riassemblaggio del frammento.
IP_PARAM_PROBLEM 11015	Un problema di parametro.
IP_SOURCE_QUENCH 11016	I datagrammi arrivano troppo velocemente per essere elaborati e i datagrammi potrebbero essere stati eliminati.
IP_OPTION_TOO_BIG 11017	Un'opzione IP era troppo grande.
IP_BAD_DESTINATION 11018	Una destinazione non valida.
IP_GENERAL_FAILURE 11050	Errore generale. Questo errore può essere restituito per alcuni pacchetti ICMP in formato non valido.

RoundTripTime

Tipo: ULONG

Tempo di round trip, espresso in millisecondi.

DataSize

Tipo: USHORT

Dimensioni dei dati, in byte, della risposta.

Reserved

Tipo: USHORT

Riservato per l'utilizzo nel sistema.

Data

Tipo: PVOID

Puntatore ai dati di risposta.

Options

Tipo: struct ip_option_information

Opzioni IP nell'intestazione IP della risposta, sotto forma di struttura IP_OPTION_INFORMATION .

Commenti

La struttura ICMP_ECHO_REPLY viene usata dalla funzione IcmpParseReplies per restituire la risposta a una richiesta echo IPv4. In una piattaforma a 64 bit, è necessario usare la struttura ICMP_ECHO_REPLY32 .

Per IPv4, alcuni dei possibili valori per il membro Status sono specificati in RFC 792.

La funzione GetIpErrorString può essere usata per recuperare la stringa di errore dell'helper IP per il codice di errore IP_STATUS nel membro Status .

La struttura ICMP_ECHO_REPLY è definita nel file di intestazione Ipexport.h , incluso automaticamente nel file di intestazione Iphlpapi.h . Il file di intestazione Ipexport.h non deve mai essere usato direttamente.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ipexport.h (include Iphlpapi.h)