FlushIpNetTable2 함수
FlushIpNetTable2 함수는 로컬 컴퓨터의 IP 인접 테이블을 플러시합니다.
구문
NETIOAPI_API FlushIpNetTable2(
_In_ ADDRESS_FAMILY Family,
_In_ NET_IFINDEX InterfaceIndex
);
매개 변수
가족 [in]
플러시할 주소 패밀리입니다.주소 패밀리에 사용할 수 있는 값은 Winsock2.h 헤더 파일에 나열됩니다. AF_ 주소 패밀리 및 PF_ 프로토콜 패밀리 상수의 값은 동일하므로(예: AF_INET 및 PF_INET) 두 상수 중 하나를 사용할 수 있습니다.
Windows Vista 이상 버전의 Windows 운영 체제에서 Family 매개 변수에 대한 가능한 값은 Ws2def.h 헤더 파일에 정의됩니다. Ws2def.h 헤더 파일은 Netioapi.h에 자동으로 포함되며 Ws2def.h를 직접 사용하면 안 됩니다.
현재 주소 패밀리에 대해 지원되는 값은 다음과 같습니다.
AF_INET
IPv4 주소 패밀리입니다. 이 값을 지정하면 이 함수는 IPv4 항목만 포함하는 인접 IP 주소 테이블을 플러시합니다.AF_INET6
IPv6 주소 패밀리입니다. 이 값을 지정하면 이 함수는 IPv6 항목만 포함하는 인접 IP 주소 테이블을 플러시합니다.AF_UNSPEC
주소 패밀리는 지정되지 않습니다. 이 값을 지정하면 이 함수는 IPv4 및 IPv6 항목이 모두 포함된 인접 IP 주소 테이블을 플러시합니다.
InterfaceIndex [in]
인터페이스 인덱스입니다. 인덱스를 지정하면 함수는 특정 인터페이스의 인접 IP 주소 항목을 플러시합니다. Ootherwise 함수는 모든 인터페이스에서 인접 IP 주소 항목을 플러시합니다. 인터페이스를 무시하려면 이 매개 변수를 0으로 설정합니다.
반환 값
FlushIpNetTable2 는 함수가 성공하면 STATUS_SUCCESS 반환합니다.
함수가 실패하면 FlushIpNetTable2 는 다음 오류 코드 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
| STATUS_INVALID_PARAMETER | 잘못된 매개 변수가 함수에 전달되었습니다. Family 매개 변수가 AF_INET, AF_INET6 또는 AF_UNSPEC 지정되지 않은 경우 이 오류가 반환됩니다. |
| STATUS_NOT_SUPPORTED | 요청이 지원되지 않습니다. 이 오류는 로컬 컴퓨터에 IPv4 스택이 없고 Family 매개 변수에 AF_INET 지정되었거나 로컬 컴퓨터에 IPv6 스택이 없고 Family 매개 변수에 AF_INET6 지정된 경우 반환됩니다. 이 오류는 이 함수가 지원되지 않는 Windows 버전에서도 반환됩니다. |
| 기타 | FormatMessage 함수를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
설명
FlushIpNetTable2 함수는 로컬 컴퓨터에서 인접 IP 주소를 플러시하거나 삭제합니다. 드라이버는 Family 매개 변수를 사용하여 인접 IP 주소를 특정 IP 주소 패밀리로 삭제하도록 제한할 수 있습니다. IPv4 및 IPv6 모두에 대한 인접 IP 주소를 삭제해야 하는 경우 드라이버는 Family 매개 변수를 AF_UNSPEC 설정해야 합니다. 드라이버는 InterfaceIndex 매개 변수를 사용하여 인접 IP 주소를 특정 인터페이스로 삭제하도록 제한할 수 있습니다. 모든 인터페이스에 대한 인접 IP 주소를 삭제해야 하는 경우 드라이버는 InterfaceIndex 매개 변수를 0으로 설정해야 합니다.
드라이버는 family 매개 변수를 AF_INET, AF_INET6 또는 AF_UNSPEC 초기화해야 합니다.
요구 사항
대상 플랫폼 |
유니버설 |
버전 |
Windows Vista 이상 버전의 Windows 운영 체제에서 사용할 수 있습니다. |
헤더 |
Netioapi.h(Netioapi.h 포함) |
라이브러리 |
Netio.lib |
Irql |
< DISPATCH_LEVEL |