Funzione IcmpParseReplies (icmpapi.h)
La funzione IcmpParseReplies analizza il buffer di risposta fornito e restituisce il numero di risposte di richiesta echo ICMP trovate.
Sintassi
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Parametri
[in] ReplyBuffer
Buffer passato a IcmpSendEcho2. Viene riscritto per contenere una matrice di strutture ICMP_ECHO_REPLY , il relativo tipo è PICMP_ECHO_REPLY.
In una piattaforma a 64 bit, questo buffer viene riscritto per contenere una matrice di strutture ICMP_ECHO_REPLY32 , il relativo tipo è PICMP_ECHO_REPLY32.
[in] ReplySize
Dimensioni, in byte, del buffer a cui punta il parametro ReplyBuffer .
Valore restituito
La funzione IcmpParseReplies restituisce il numero di risposte ICMP trovate sull'esito positivo. La funzione restituisce zero in caso di errore. Chiamare GetLastError per ulteriori informazioni sugli errori.
Commenti
La funzione IcmpParseReplies non deve essere usata in un buffer di risposta passato in precedenza a IcmpSendEcho. La funzione IcmpSendEcho analizza il buffer prima di tornare all'utente. Usare questa funzione solo con IcmpSendEcho2.
La funzione IcmpParseReplies viene esportata dalla Icmp.dll in Windows 2000. La funzione IcmpParseReplies viene esportata dalla Iphlpapi.dll in Windows XP e versioni successive. Il controllo delle versioni di Windows non è consigliabile usare questa funzione. Le applicazioni che richiedono la portabilità con questa funzione in Windows 2000, Windows XP, Windows Server 2003 e versioni successive di Windows non devono essere collegate staticamente al file Icmp.lib o al file Iphlpapi.lib . L'applicazione deve invece verificare la presenza di IcmpParseReplies nella Iphlpapi.dll con chiamate a LoadLibrary e GetProcAddress. In caso contrario, l'applicazione deve verificare la presenza di IcmpParseReplies nel Icmp.dll con chiamate a LoadLibrary e GetProcAddress.
Si noti che la direttiva di inclusione per il file di intestazione Iphlpapi.h deve essere inserita prima del file di intestazione Icmpapi.h .
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | icmpapi.h |
| Libreria | Iphlpapi.lib |
| DLL | Iphlpapi.dll in Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP; Icmp.dll in Windows 2000 Server e Windows 2000 Professional |
Vedi anche
IcmpSendEcho