Função Icmp6CreateFile (icmpapi.h)

Artigo
08/24/2023

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