Icmp6CreateFile 함수(icmpapi.h)

Icmp6CreateFile 함수는 IPv6 ICMP 에코 요청을 실행할 수 있는 핸들을 엽니다.

구문

IPHLPAPI_DLL_LINKAGE HANDLE Icmp6CreateFile();

반환 값

Icmp6CreateFile 함수는 성공 시 열린 핸들을 반환합니다. 실패 시 함수는 INVALID_HANDLE_VALUE 반환합니다. 확장 오류 정보는 GetLastError 함수를 호출합니다.

설명

Icmp6CreateFile 함수는 IPv6 ICMP 에코 요청을 실행할 수 있는 핸들을 엽니다. Icmp6SendEcho2 함수는 IPv6 ICMP 에코 요청을 보내는 데 사용됩니다. Icmp6ParseReplies 함수는 IPv6 ICMP 회신을 구문 분석하는 데 사용됩니다. IcmpCloseHandle 함수는 Icmp6CreateFile 함수에서 연 ICMP 핸들을 닫는 데 사용됩니다.

IPv4의 경우 IcmpCreateFile 함수를 사용합니다.

IPv4의 경우 IcmpCreateFile, IcmpSendEcho, IcmpSendEcho2, IcmpSendEcho2Ex 및 IcmpParseReplies 함수를 사용합니다.

Iphlpapi.h 헤더 파일에 대한 include 지시문은 Icmpapi.h 헤더 파일 앞에 배치해야 합니다.

예제

다음 예제에서는 IPv6 ICMP 에코 요청을 실행할 수 있는 핸들을 엽니다.

#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
헤더	icmpapi.h
라이브러리	Iphlpapi.lib
DLL	Iphlpapi.dll