Funzione Icmp6ParseReplies (icmpapi.h)

Articolo
08/24/2023

La funzione Icmp6ParseReplies analizza il buffer di risposta fornito e restituisce una risposta echo ICMPv6 IPv6, se trovata.

Sintassi

IPHLPAPI_DLL_LINKAGE DWORD Icmp6ParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

Parametri

[in] ReplyBuffer

Puntatore al buffer passato alla funzione Icmp6SendEcho2 . Questo parametro punta a una struttura ICMPV6_ECHO_REPLY che contiene la risposta.

[in] ReplySize

Dimensione, in byte, del buffer a cui punta il parametro ReplyBuffer .

Valore restituito

La funzione Icmp6ParseReplies restituisce 1 in caso di esito positivo. In questo caso, il membro Status nella struttura ICMPV6_ECHO_REPLY a cui punta il parametro ReplyBuffer verrà IP_SUCCESS se il nodo di destinazione ha risposto o IP_TTL_EXPIRED_TRANSIT.

Se il valore restituito è zero, le informazioni sull'errore estese sono disponibili tramite GetLastError.

Codice restituito	Descrizione
ERROR_GEN_FAILURE	Si è verificato un errore generale. Questo errore viene restituito se il parametro ReplyBuffer è un puntatore NULL o il parametro ReplySize è zero.
Altri	Usare FormatMessage per ottenere la stringa del messaggio per l'errore restituito.

Commenti

La funzione Icmp6ParseReplies viene usata da IPv6 per analizzare le risposte risultanti da una richiesta echo ICMPv6. La funzione Icmp6ParseReplies analizza un buffer di risposta passato in precedenza alla funzione Icmp6SendEcho2 . Usare la funzione Icmp6ParseReplies solo con la funzione Icmp6SendEcho2 .

Non è possibile usare la funzione Icmp6ParseReplies in un buffer di risposta passato in precedenza a IcmpSendEcho o IcmpSendEcho2 per IPv4.

Per IPv4, usare le funzioni IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex e IcmpParseReplies .

Si noti che la direttiva include per il file di intestazione Iphlpapi.h deve essere inserita prima del file di intestazione Icmpapi.h .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	icmpapi.h
Libreria	Iphlpapi.lib
DLL	Iphlpapi.dll