Função Icmp6ParseReplies (icmpapi.h)

Artigo
02/28/2024

A função Icmp6ParseReplies analisa o buffer de resposta fornecido e retorna uma resposta de resposta de eco IPv6 ICMPv6, se encontrada.

Sintaxe

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

Parâmetros

[in] ReplyBuffer

Um ponteiro para o buffer passado para a função Icmp6SendEcho2 . Esse parâmetro aponta para uma estrutura ICMPV6_ECHO_REPLY para manter a resposta.

[in] ReplySize

O tamanho, em bytes, do buffer apontado pelo parâmetro ReplyBuffer .

Retornar valor

A função Icmp6ParseReplies retorna 1 em caso de êxito. Nesse caso, o membro Status na estrutura ICMPV6_ECHO_REPLY apontada pelo parâmetro ReplyBuffer será IP_SUCCESS se o nó de destino tiver respondido ou IP_TTL_EXPIRED_TRANSIT.

Se o valor retornado for zero, as informações de erro estendidas ficarão disponíveis por meio de GetLastError.

Código de retorno	Descrição
ERROR_GEN_FAILURE	Ocorreu uma falha geral. Esse erro será retornado se o parâmetro ReplyBuffer for um ponteiro NULL ou o parâmetro ReplySize for zero.
Outros	Use FormatMessage para obter a cadeia de caracteres de mensagem para o erro retornado.

Comentários

A função Icmp6ParseReplies é usada pelo IPv6 para analisar respostas resultantes de uma solicitação de eco ICMPv6. A função Icmp6ParseReplies analisa um buffer de resposta passado anteriormente para a função Icmp6SendEcho2 . Use a função Icmp6ParseReplies somente com a função Icmp6SendEcho2 .

A função Icmp6ParseReplies não pode ser usada em um buffer de resposta passado anteriormente para IcmpSendEcho ou IcmpSendEcho2 para IPv4.

Para IPv4, use as funções IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex e IcmpParseReplies .

Observe que a diretiva include para o arquivo de cabeçalho Iphlpapi.h deve ser colocada antes do arquivo de cabeçalho Icmpapi.h .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	icmpapi.h
Biblioteca	Iphlpapi.lib
DLL	Iphlpapi.dll