Функция Icmp6CreateFile (icmpapi.h)

Статья
08/24/2023

Функция Icmp6CreateFile открывает дескриптор, на котором можно выдавать эхо-запросы IPv6 ICMP.

Синтаксис

IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();

Возвращаемое значение

Функция Icmp6CreateFile возвращает открытый дескриптор при успешном выполнении. При сбое функция возвращает INVALID_HANDLE_VALUE. Вызовите функцию GetLastError для получения дополнительных сведений об ошибке.

Функция Icmp6CreateFile открывает дескриптор, на котором можно выдавать эхо-запросы IPv6 ICMP. Функция Icmp6SendEcho2 используется для отправки эхо-запросов IPv6 ICMP. Функция Icmp6ParseReplies используется для анализа ответов IPv6 ICMP. Функция IcmpCloseHandle используется для закрытия дескриптора ICMP, открытого функцией Icmp6CreateFile .

Для IPv4 используйте функцию IcmpCreateFile .

Для IPv4 используйте функции IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex и IcmpParseReplies .

Обратите внимание, что директива include для файла заголовка Iphlpapi.h должна быть помещена перед файлом заголовка Icmpapi.h .

Примеры

В следующем примере открывается дескриптор, на котором можно выдавать эхо-запросы 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");
}

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	icmpapi.h
Библиотека	Iphlpapi.lib
DLL	Iphlpapi.dll