[이 API는 라우팅 테이블 관리자 버전 2 API로 대체되었으며 Windows Server 2003 이후로는 사용할 수 없습니다. 애플리케이션은 라우팅 테이블 관리자 버전 2 API를 사용해야 합니다.]
RtmGetNextRoute 함수는 테이블의 지정된 경로 하위 집합에서 다음 경로를 반환합니다.
구문
DWORD RtmGetNextRoute(
_In_ DWORD ProtocolFamily,
_In_ DWORD EnumerationFlags,
_Inout_ PVOID Route
);
매개 변수
-
ProtocolFamily [in]
-
검색할 경로의 프로토콜 패밀리(예: IP 또는 IPX)를 지정합니다.
-
EnumerationFlags [in]
-
열거할 경로를 지정합니다. 이 매개 변수는 삭제된 경로 집합을 다음 플래그로 정의된 하위 집합으로 제한하고 CriteriaRoute 매개 변수가 가리키는 구조체의 해당 멤버에 있는 값을 제한합니다. 플래그는 RtmCreateEnumerationHandle에 사용된 플래그와 동일합니다.
-
경로 [in, out]
-
입력에서 Route 는 프로토콜 패밀리별 구조( RTM_IP_ROUTE 또는 RTM_IPX_ROUTE)를 가리킵니다.
호출 함수는 이 구조체에 대한 멤버 값을 제공합니다. 이러한 값은 EnumerationFlags 매개 변수와 함께 경로를 반환할 집합을 지정합니다.
출력에서 Route 는 지정된 조건과 일치하는 첫 번째 경로를 수신하는 구조를 가리킵니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 설명 |
|---|---|
|
매개 변수 중 하나가 잘못되었습니다. |
|
지정된 조건과 일치하는 경로가 없습니다. |
|
작업을 수행할 리소스가 부족합니다. |
설명
경로는 다음 순서로 반환됩니다.
- 네트워크 번호
- 라우팅 프로토콜
- 인터페이스 식별자
- 다음 홉 주소
이 함수는 해당 열거형 핸들 함수보다 효율성이 떨어집니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
지원되는 버전 없음 |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|