MIB_IPFORWARD_ROW2 구조체(netioapi.h)
MIB_IPFORWARD_ROW2 구조체는 IP 경로 항목에 대한 정보를 저장합니다.
구문
typedef struct _MIB_IPFORWARD_ROW2 {
NET_LUID InterfaceLuid;
NET_IFINDEX InterfaceIndex;
IP_ADDRESS_PREFIX DestinationPrefix;
SOCKADDR_INET NextHop;
UCHAR SitePrefixLength;
ULONG ValidLifetime;
ULONG PreferredLifetime;
ULONG Metric;
NL_ROUTE_PROTOCOL Protocol;
BOOLEAN Loopback;
BOOLEAN AutoconfigureAddress;
BOOLEAN Publish;
BOOLEAN Immortal;
ULONG Age;
NL_ROUTE_ORIGIN Origin;
} MIB_IPFORWARD_ROW2, *PMIB_IPFORWARD_ROW2;
멤버
InterfaceLuid
형식: NET_LUID
이 IP 경로 항목과 연결된 네트워크 인터페이스에 대한 LUID(로컬 고유 식별자)입니다.
InterfaceIndex
형식: NET_IFINDEX
이 IP 경로 항목과 연결된 네트워크 인터페이스의 로컬 인덱스 값입니다. 이 인덱스 값은 네트워크 어댑터를 사용하지 않도록 설정한 다음 사용하도록 설정하거나 다른 상황에서 변경될 수 있으며 영구로 간주해서는 안 됩니다.
DestinationPrefix
이 경로의 대상 IP 주소에 대한 IP 주소 접두사입니다.
NextHop
형식: SOCKADDR_INET
원격 경로의 경우 다음 시스템 또는 게이트웨이의 IP 주소가 라우팅됩니다. 경로가 로컬 루프백 주소 또는 로컬 링크의 IP 주소인 경우 다음 홉은 지정되지 않습니다(모두 0). 로컬 루프백 경로의 경우 이 멤버는 IPv4 경로 항목의 경우 0.0.0.0의 IPv4 주소이거나 IPv6 경로 항목의 경우 0::0의 IPv6 주소여야 합니다.
SitePrefixLength
형식: UCHAR
이 경로에 대한 IP 주소의 사이트 접두사 또는 네트워크 부분의 길이(비트)입니다. IPv4 경로 항목의 경우 32보다 큰 값은 잘못된 값입니다. IPv6 경로 항목의 경우 128보다 큰 값은 잘못된 값입니다. 값 255는 일반적으로 잘못된 값을 나타내는 데 사용됩니다.
ValidLifetime
형식: ULONG
IP 경로 항목이 유효한 최대 시간(초)입니다. 0xffffffff 값은 무한으로 간주됩니다.
PreferredLifetime
형식: ULONG
IP 경로 항목이 유효한 기본 설정 시간(초)입니다. 0xffffffff 값은 무한으로 간주됩니다.
Metric
형식: ULONG
이 IP 경로 항목에 대한 경로 메트릭 오프셋 값입니다. 경로 기본 설정을 계산하는 데 사용되는 실제 경로 메트릭은 MIB_IPINTERFACE_ROW 구조체의 메트릭 멤버에 지정된 인터페이스 메트릭과 이 멤버에 지정된 경로 메트릭 오프셋의 합계입니다. 이 메트릭의 의미 체계는 프로토콜 멤버에 지정된 라우팅 프로토콜에 의해 결정됩니다. 이 메트릭을 사용하지 않으면 해당 값을 -1로 설정해야 합니다. 이 값은 RFC 4292에 설명되어 있습니다. 자세한 내용은 http://www.ietf.org/rfc/rfc4292.txt를 참조하세요.
Protocol
형식: NL_ROUTE_PROTOCOL
이 IP 경로가 추가된 라우팅 메커니즘입니다. 이 멤버는 Nldef.h 헤더 파일에 정의된 NL_ROUTE_PROTOCOL 열거형 형식의 값 중 하나일 수 있습니다. 멤버는 RFC 4292에 설명되어 있습니다. 자세한 내용은 http://www.ietf.org/rfc/rfc4292.txt를 참조하세요.
Nldef.h 헤더는 Iprtrmib.h 헤더에 의해 자동으로 포함되는 Ipmib.h 헤더 파일에 의해 자동으로 포함됩니다. Iphlpapi.h 헤더에는 Iprtrmib.h 헤더 파일이 자동으로 포함됩니다. Iprtrmib.h, Ipmib.h 및 Nldef.h 헤더 파일은 직접 사용하면 안 됩니다.
다음 목록에서는 이 멤버에 대해 가능한 값을 보여 주세요.
| 값 | 의미 |
|---|---|
|
라우팅 메커니즘이 지정되지 않았습니다. |
|
로컬 인터페이스입니다. |
|
정적 경로입니다. 이 값은 DCHP(동적 호스트 구성 프로토콜), SNMP(Simple Network Management Protocol) 또는 CreateIpForwardEntry2, DeleteIpForwardEntry2 또는 SetIpForwardEntry2 함수에 대한 호출과 같은 네트워크 관리를 통해 설정된 IP 라우팅에 대한 경로 정보를 식별하는 데 사용됩니다. |
|
ICMP 리디렉션의 결과입니다. |
|
동적 라우팅 프로토콜인 EGP(외부 게이트웨이 프로토콜)입니다. |
|
동적 라우팅 프로토콜인 GGP(게이트웨이-게이트웨이 프로토콜)입니다. |
|
동적 라우팅 프로토콜인 Hellospeak 프로토콜입니다. 이는 더 이상 사용되지 않는 기록 항목이며 RFC 891 및 RFC 1305에 설명된 대로 Hellospeak이라고도 하는 특수 소프트웨어를 실행한 원래 ARPANET 라우터에서 사용하는 초기 라우팅 프로토콜입니다. 자세한 내용은 http://www.ietf.org/rfc/rfc891.txt 및 http://www.ietf.org/rfc/rfc1305.txt를 참조하세요. |
|
동적 라우팅 프로토콜인 RIP(Berkeley Routing Information Protocol) 또는 RIP-II. |
|
동적 라우팅 프로토콜인 IS-IS(중간 시스템 간 시스템) 프로토콜입니다. IS-IS 프로토콜은 OSI(Open Systems Interconnection) 프로토콜 제품군에서 사용하기 위해 개발되었습니다. |
|
동적 라우팅 프로토콜인 ES-IS(End System-to-Intermediate System) 프로토콜입니다. ES-IS 프로토콜은 OSI(Open Systems Interconnection) 프로토콜 제품군에서 사용하기 위해 개발되었습니다. |
|
동적 라우팅 프로토콜인 IGRP(Cisco Interior Gateway 라우팅 프로토콜)입니다. |
|
SPF(최단 경로 우선) 알고리즘을 사용한 Bolt, Beranek 및 Newman(BBN) IGP(내부 게이트웨이 프로토콜)입니다. 이는 초기 동적 라우팅 프로토콜이었습니다. |
|
OSPF(Open Shortest Path First) 프로토콜, 동적 라우팅 프로토콜입니다. |
|
동적 라우팅 프로토콜인 BGP(Border Gateway Protocol)입니다. |
|
라우팅 프로토콜에 의해 원래 추가되었지만 지금은 정적인 Windows 특정 항목입니다. |
|
라우팅 사용자 인터페이스 또는 라우팅 명령에서 정적 경로로 추가된 Windows 특정 항목입니다. |
|
이러한 경로를 제외하면 라우팅 사용자 인터페이스 또는 라우팅 명령에서 정적 경로로 추가된 Windows 특정 항목은 DOD(Dial On Demand)를 유발하지 않습니다. |
Loopback
형식: BOOLEAN
경로가 루프백 경로인지(게이트웨이가 로컬 호스트에 있는지) 지정하는 값입니다.
AutoconfigureAddress
형식: BOOLEAN
IP 주소가 자동으로 구성되었는지를 지정하는 값입니다.
Publish
형식: BOOLEAN
경로가 게시되는지를 지정하는 값입니다.
Immortal
형식: BOOLEAN
경로가 불멸인지를 지정하는 값입니다.
Age
형식: ULONG
경로가 네트워크 라우팅 테이블에서 추가되거나 수정된 이후의 시간(초)입니다.
Origin
형식: NL_ROUTE_ORIGIN
경로의 원본입니다. 이 멤버는 Nldef.h 헤더 파일에 정의된 NL_ROUTE_ORIGIN 열거형 형식의 값 중 하나일 수 있습니다.
| 값 | 의미 |
|---|---|
|
수동 구성의 결과입니다. |
|
잘 알려진 경로입니다. |
|
DHCP 구성의 결과입니다. |
|
라우터 보급의 결과입니다. |
|
6to4 터널링의 결과입니다. |
설명
MIB_IPFORWARD_ROW2 구조체는 Windows Vista 이상에서 정의됩니다.
GetIpForwardTable2 함수는 로컬 시스템의 IP 경로 항목을 열거하고 MIB_IPFORWARD_TABLE2 구조에서 이 정보를 MIB_IPFORWARD_ROW2 항목의 배열로 반환합니다.
GetIpForwardEntry2 함수는 단일 IP 경로 항목을 검색하고 이 정보를 MIB_IPFORWARD_ROW2 구조로 반환합니다.
MIB_IPFORWARD_ROW2 구조체의 DestinationPrefix 멤버에서 prefix 및 IP_ADDRESS_PREFIXPrefixLength 멤버가 0으로 설정된 항목 은 기본 경로로 간주됩니다. MIB_IPFORWARD_TABLE2여러 네트워크 어댑터가 설치된 경우 DestinationPrefix 멤버에서 접두사 및 IP_ADDRESS_PREFIXPrefixLength 멤버가 0으로 설정된 여러 MIB_IPFORWARD_ROW2 항목을 포함할 수 있습니다.
MIB_IPFORWARD_ROW2 항목의 메트릭 멤버는 해당 경로 사용과 관련된 비용을 식별하는 특정 네트워크 인터페이스의 IP 경로에 할당된 값입니다. 예를 들어 링크 속도, 홉 수 또는 시간 지연 측면에서 메트릭을 반환할 수 있습니다. 자동 메트릭은 Windows XP 이상에서 링크 속도를 기반으로 하는 로컬 경로에 대한 메트릭을 자동으로 구성하는 기능입니다. 자동 메트릭 기능은 Windows XP 이상에서 기본적으로 사용하도록 설정됩니다(MIB_IPINTERFACE_ROW 구조의 UseAutomaticMetric 멤버는 TRUE로 설정됨). IP 경로에 특정 메트릭을 할당하도록 수동으로 구성할 수도 있습니다.
MIB_IPFORWARD_ROW2 구조체의 메트릭 멤버에 지정된 경로 메트릭은 경로 메트릭 오프셋만 나타냅니다. 전체 메트릭은 연결된 인터페이스의 MIB_IPINTERFACE_ROW 구조의 메트릭 멤버에 지정된 인터페이스 메트릭에 추가된 이 경로 메트릭 오프셋의 조합입니다. 애플리케이션은 GetIpInterfaceEntry 함수를 호출하여 인터페이스 메트릭을 검색할 수 있습니다.
Netioapi.h 헤더 파일은 Iphlpapi.h 헤더 파일에 자동으로 포함됩니다. Netioapi.h 헤더 파일은 직접 사용하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | netioapi.h(Iphlpapi.h 포함) |