Función Icmp6ParseReplies (icmpapi.h)

Artículo
02/28/2024

La función Icmp6ParseReplies analiza el búfer de respuesta proporcionado y devuelve una respuesta de respuesta de eco ICMPv6 IPv6 si se encuentra.

Sintaxis

IPHLPAPI_DLL_LINKAGE DWORD Icmp6ParseReplies(
  [in] LPVOID ReplyBuffer,
  [in] DWORD  ReplySize
);

Parámetros

[in] ReplyBuffer

Puntero al búfer pasado a la función Icmp6SendEcho2 . Este parámetro apunta a una estructura ICMPV6_ECHO_REPLY para contener la respuesta.

[in] ReplySize

Tamaño, en bytes, del búfer al que apunta el parámetro ReplyBuffer .

Valor devuelto

La función Icmp6ParseReplies devuelve 1 si se ejecuta correctamente. En este caso, el miembro Status de la estructura ICMPV6_ECHO_REPLY a la que apunta el parámetro ReplyBuffer será IP_SUCCESS si el nodo de destino respondió o IP_TTL_EXPIRED_TRANSIT.

Si el valor devuelto es cero, la información de error extendida está disponible a través de GetLastError.

Código devuelto	Descripción
ERROR_GEN_FAILURE	Error general. Este error se devuelve si el parámetro ReplyBuffer es un puntero NULL o el parámetro ReplySize es cero.
Otros	Use FormatMessage para obtener la cadena de mensaje del error devuelto.

Comentarios

La función Icmp6ParseReplies se usa en IPv6 para analizar las respuestas resultantes de una solicitud de eco ICMPv6. La función Icmp6ParseReplies analiza un búfer de respuesta pasado anteriormente a la función Icmp6SendEcho2 . Use la función Icmp6ParseReplies solo con la función Icmp6SendEcho2 .

La función Icmp6ParseReplies no se puede usar en un búfer de respuesta pasado previamente a IcmpSendEcho o IcmpSendEcho2 para IPv4.

Para IPv4, use las funciones IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex e IcmpParseReplies .

Tenga en cuenta que la directiva include para el archivo de encabezado Iphlpapi.h debe colocarse antes del archivo de encabezado Icmpapi.h .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	icmpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll