Función Icmp6CreateFile (icmpapi.h)

Artículo
08/24/2023

La función Icmp6CreateFile abre un identificador en el que se pueden emitir solicitudes de eco ICMP IPv6.

Sintaxis

IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();

Valor devuelto

La función Icmp6CreateFile devuelve un identificador abierto si se ejecuta correctamente. En caso de error, la función devuelve INVALID_HANDLE_VALUE. Llame a la función GetLastError para obtener información de error extendida.

Comentarios

La función Icmp6CreateFile abre un identificador en el que se pueden emitir solicitudes de eco ICMP IPv6. La función Icmp6SendEcho2 se usa para enviar las solicitudes de eco ICMP IPv6. La función Icmp6ParseReplies se usa para analizar las respuestas ICMP de IPv6. La función IcmpCloseHandle se usa para cerrar el identificador ICMP abierto por la función Icmp6CreateFile .

Para IPv4, use la función IcmpCreateFile .

Para IPv4, use las funciones IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex e IcmpParseReplies .

Tenga en cuenta que la directiva include para el archivo de encabezado Iphlpapi.h debe colocarse antes del archivo de encabezado Icmpapi.h .

Ejemplos

En el ejemplo siguiente se abre un identificador en el que se pueden emitir solicitudes de eco ICMP IPv6.

#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 compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	icmpapi.h
Library	Iphlpapi.lib
Archivo DLL	Iphlpapi.dll