Compartilhar via


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

Obter Último Erro

Icmp6ParseReplies

Icmp6SendEcho2

IcmpCloseHandle

Icmpcreatefile

IcmpParseReplies

IcmpSendEcho

IcmpSendEcho2

IcmpSendEcho2Ex