Função Icmp6ParseReplies (icmpapi.h)
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 |
|---|---|
|
Ocorreu uma falha geral. Esse erro será retornado se o parâmetro ReplyBuffer for um ponteiro NULL ou o parâmetro ReplySize for zero. |
|
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 |
Confira também
IcmpSendEcho