Función IcmpParseReplies (icmpapi.h)
La función IcmpParseReplies analiza el búfer de respuesta proporcionado y devuelve el número de respuestas de solicitud de eco ICMP encontradas.
Sintaxis
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Parámetros
[in] ReplyBuffer
Búfer pasado a IcmpSendEcho2. Se vuelve a escribir para contener una matriz de estructuras de ICMP_ECHO_REPLY , su tipo es PICMP_ECHO_REPLY.
En una plataforma de 64 bits, este búfer se reescribe para contener una matriz de estructuras de ICMP_ECHO_REPLY32 , su tipo es PICMP_ECHO_REPLY32.
[in] ReplySize
Tamaño, en bytes, del búfer al que apunta el parámetro ReplyBuffer .
Valor devuelto
La función IcmpParseReplies devuelve el número de respuestas ICMP encontradas correctamente. La función devuelve cero al error. Llame a GetLastError para obtener información de error adicional.
Comentarios
La función IcmpParseReplies no se debe usar en un búfer de respuesta pasado anteriormente a IcmpSendEcho. La función IcmpSendEcho analiza ese búfer antes de volver al usuario. Use esta función solo con IcmpSendEcho2.
La función IcmpParseReplies se exporta desde el Icmp.dll en Windows 2000. La función IcmpParseReplies se exporta desde el Iphlpapi.dll en Windows XP y versiones posteriores. No se recomienda la comprobación de versiones de Windows para usar esta función. Las aplicaciones que requieren portabilidad con esta función en Windows 2000, Windows XP, Windows Server 2003 y versiones posteriores de Windows no deben vincularse estáticamente al archivo Icmp.lib o Iphlpapi.lib . En su lugar, la aplicación debe comprobar la presencia de IcmpParseReplies en el Iphlpapi.dll con llamadas a LoadLibrary y GetProcAddress. Si se produce un error, la aplicación debe comprobar la presencia de IcmpParseReplies en el Icmp.dll con llamadas a LoadLibrary y GetProcAddress.
Tenga en cuenta que la directiva include para el archivo de encabezado Iphlpapi.h debe colocarse antes del archivo de encabezado Icmpapi.h .
Requisitos
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | icmpapi.h |
| Library | Iphlpapi.lib |
| Archivo DLL | Iphlpapi.dll en Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP; Icmp.dll en Windows 2000 Server y Windows 2000 Professional |
Consulte también
IcmpSendEcho