Função Icmp6CreateFile (icmpapi.h)
A função Icmp6CreateFile abre um identificador no qual as solicitações de eco IPv6 ICMP podem ser emitidas.
Sintaxe
IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();
Valor retornado
A função Icmp6CreateFile retorna um identificador aberto com êxito. Em caso de falha, a função retorna INVALID_HANDLE_VALUE. Chame a função GetLastError para obter informações de erro estendidas.
Comentários
A função Icmp6CreateFile abre um identificador no qual as solicitações de eco IPv6 ICMP podem ser emitidas. A função Icmp6SendEcho2 é usada para enviar as solicitações de eco IPv6 ICMP. A função Icmp6ParseReplies é usada para analisar as respostas ICMP IPv6. A função IcmpCloseHandle é usada para fechar o identificador ICMP aberto pela função Icmp6CreateFile .
Para IPv4, use a função IcmpCreateFile .
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 .
Exemplos
O exemplo a seguir abre um identificador no qual as solicitações de eco ICMP IPv6 podem ser emitidas.
#include <windows.h>
#include <stdio.h>
#include <iphlpapi.h>
#include <icmpapi.h>
#pragma comment(lib, "IPHLPAPI.lib")
void main()
{
HANDLE hIcmpFile;
hIcmpFile = Icmp6CreateFile();
if (hIcmpFile == INVALID_HANDLE_VALUE) {
printf("\tUnable to open handle.\n");
printf("Icmp6Createfile returned error: %ld\n", GetLastError() );
}
else
printf("\tHandle created.\n");
}
Requisitos
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | icmpapi.h |
| Biblioteca | Iphlpapi.lib |
| DLL | Iphlpapi.dll |
Confira também
IcmpSendEcho