Funzione IcmpParseReplies (icmpapi.h)

Articolo
08/24/2023

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