Funzione Icmp6ParseReplies (icmpapi.h)

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

Vedi anche

Getlasterror

ICMPV6_ECHO_REPLY

ICMP_ECHO_REPLY

Icmp6CreateFile

Icmp6SendEcho2

IcmpCloseHandle

IcmpCreateFile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex