Função IcmpParseReplies (icmpapi.h)
A função IcmpParseReplies analisa o buffer de resposta fornecido e retorna o número de respostas de solicitação de eco ICMP encontradas.
Sintaxe
IPHLPAPI_DLL_LINKAGE DWORD IcmpParseReplies(
[in] LPVOID ReplyBuffer,
[in] DWORD ReplySize
);
Parâmetros
[in] ReplyBuffer
O buffer passado para IcmpSendEcho2. Isso é reescrito para manter uma matriz de estruturas ICMP_ECHO_REPLY , seu tipo é PICMP_ECHO_REPLY.
Em uma plataforma de 64 bits, esse buffer é reescrito para conter uma matriz de estruturas ICMP_ECHO_REPLY32 , seu tipo é PICMP_ECHO_REPLY32.
[in] ReplySize
O tamanho, em bytes, do buffer apontado pelo parâmetro ReplyBuffer .
Valor retornado
A função IcmpParseReplies retorna o número de respostas ICMP encontradas em caso de êxito. A função retorna zero em caso de erro. Chame GetLastError para obter informações adicionais de erro.
Comentários
A função IcmpParseReplies não deve ser usada em um buffer de resposta passado anteriormente para IcmpSendEcho. A função IcmpSendEcho analisa esse buffer antes de retornar ao usuário. Use essa função somente com IcmpSendEcho2.
A função IcmpParseReplies é exportada do Icmp.dll no Windows 2000. A função IcmpParseReplies é exportada do Iphlpapi.dll no Windows XP e posterior. A verificação de versão do Windows não é recomendada para usar essa função. Aplicativos que exigem portabilidade com essa função no Windows 2000, Windows XP, Windows Server 2003 e versões posteriores do Windows não devem vincular estaticamente ao arquivo Icmp.lib ou Iphlpapi.lib . Em vez disso, o aplicativo deve marcar para a presença de IcmpParseReplies no Iphlpapi.dll com chamadas para LoadLibrary e GetProcAddress. Caso contrário, o aplicativo deve marcar para a presença de IcmpParseReplies no Icmp.dll com chamadas para LoadLibrary e GetProcAddress.
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
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | icmpapi.h |
| Biblioteca | Iphlpapi.lib |
| DLL | Iphlpapi.dll no Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP; Icmp.dll no Windows 2000 Server e no Windows 2000 Professional |
Confira também
IcmpSendEcho