SetIpForwardEntry2 함수
SetIpForwardEntry2 함수는 로컬 컴퓨터에서 IP 경로 항목의 속성을 설정합니다.
통사론
NETIOAPI_API SetIpForwardEntry2(
_In_ const MIB_IPFORWARD_ROW2 *Route
);
매개 변수
-
경로 [in]
IP 경로 항목에 대한 MIB_IPFORWARD_ROW2 구조체 항목에 대한 포인터입니다. 드라이버는 MIB_IPFORWARD_ROW2 구조체의 DestinationPrefix 멤버를 유효한 IP 대상 접두사 및 패밀리로 설정하고, MIB_IPFORWARD_ROW2 NextHop 멤버를 유효한 IP 주소 및 패밀리로 설정하고, InterfaceLuid 멤버 또는 MIB_IPFORWARD_ROW2 InterfaceIndex 멤버를 지정해야 합니다.
반환 값
SetIpForwardEntry2 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 setIpForwardEntry2 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 묘사 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. 이 오류는 NULL 포인터가 Route 매개 변수에 전달되고 Route 매개 변수가 가리키는 MIB_IPFORWARD_ROW2 구조의 DestinationPrefix 멤버가 지정되지 않은 경우 반환되며 MIB_IPFORWARD_ROW2 구조체의 NextHop 멤버는 지정되지 않았습니다. 또는 InterfaceLuid 및 InterfaceIndex MIB_IPFORWARD_ROW2 구조체의 멤버가 모두 지정되지 않았습니다. |
| STATUS_NOT_FOUND | 지정된 인터페이스를 찾을 수 없습니다. 이 오류는 함수가 Route 매개 변수가 가리키는 MIB_IPFORWARD_ROW2 구조체의 InterfaceLuid 또는 InterfaceIndex 멤버로 지정된 네트워크 인터페이스를 찾을 수 없는 경우 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
발언
SetIpForwardEntry2 함수는 로컬 컴퓨터에서 기존 IP 경로 항목에 대한 속성을 설정하는 데 사용됩니다.
드라이버는 Row 매개 변수가 가리키는 MIB_IPFORWARD_ROW2 구조체의 다음 멤버를 초기화해야 합니다.
destinationPrefix
유효한 IPv4 또는 IPv6 주소 접두사 및 패밀리로 설정합니다.NextHop
유효한 IPv4 또는 IPv6 주소 및 패밀리로 설정합니다.InterfaceLuid 또는 InterfaceIndex
이러한 멤버는 이전에 나열된 순서대로 사용됩니다. 따라서 InterfaceLuid 지정된 경우 이 멤버를 사용하여 인터페이스를 확인합니다. InterfaceLuid 멤버에 대해 값이 설정되지 않은 경우(이 멤버의 값이 0으로 설정된 경우) InterfaceIndex 멤버를 사용하여 인터페이스를 확인합니다.
경로 매개 변수를 전체 경로 메트릭의 일부만 나타내도록 가리키는 MIB_IPFORWARD_ROW2 구조의 메트릭 멤버에 지정된 경로 메트릭 오프셋입니다. 전체 메트릭은 연결된 인터페이스의 MIB_IPINTERFACE_ROW 구조의 메트릭 멤버에 지정된 인터페이스 메트릭에 추가된 이 경로 메트릭 오프셋의 조합입니다. 드라이버는 GetIpInterfaceEntry 함수를 호출하여 인터페이스 메트릭을 검색할 수 있습니다.
SetIpForwardEntry2Row 매개 변수가 가리키는 MIB_IPFORWARD_ROW2 구조의 Age 및 Origin 멤버를 무시합니다. 이러한 멤버는 네트워크 스택에 의해 설정되며 SetIpForwardEntry2 함수를 사용하여 변경할 수 없습니다.
SetIpForwardEntry2 함수는 DestinationPrefix 및 NextHop이 Route 매개 변수가 지정된 인터페이스의 IP 경로 항목과 일치하지 않도록 가리키는 MIB_IPFORWARD_ROW2 구조의 멤버를 경우 실패합니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
머리글 |
Netioapi.h(Netioapi.h 포함) |
도서관 |
Netio.lib |
IRQL |
< DISPATCH_LEVEL |