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 |
|---|---|
|
Si è verificato un errore generale. Questo errore viene restituito se il parametro ReplyBuffer è un puntatore NULL o il parametro ReplySize è zero. |
|
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
IcmpSendEcho