Función IcmpParseReplies (icmpapi.h)

Artículo
08/24/2023

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