[이 API는 라우팅 테이블 관리자 버전 2 API로 대체되었으며 Windows Server 2003 이후로는 사용할 수 없습니다. 애플리케이션은 라우팅 테이블 관리자 버전 2 API를 사용해야 합니다.]
RtmCreateEnumerationHandle 함수는 RtmEnumerateGetNextRoute와 함께 사용하여 모든 경로 또는 라우팅 테이블 관리자에 알려진 경로의 하위 집합을 검사하는 데 사용할 핸들을 반환합니다.
구문
HANDLE RtmCreateEnumerationHandle(
_In_ DWORD ProtocolFamily,
_In_ DWORD EnumerationFlags,
_In_ PVOID CriteriaRoute
);
매개 변수
-
ProtocolFamily [in]
-
열거할 경로의 프로토콜 패밀리를 지정합니다.
-
EnumerationFlags [in]
-
열거할 경로를 지정합니다. 이 매개 변수는 열거형 API에서 반환된 경로 집합을 다음 플래그로 정의된 하위 집합으로 제한하고 CriteriaRoute 매개 변수가 가리키는 구조체의 해당 멤버에 있는 값을 제한합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.
EnumerationFlags 의미 - RTM_ONLY_THIS_NETWORK
CriteriaRoute가 가리키는 구조체의 RR_Network 멤버와 네트워크 번호가 같은 경로만 열거합니다. - RTM_ONLY_THIS_INTERFACE
CriteriaRoute가 가리키는 구조체의 RR_InterfaceID 필드에 지정된 인터페이스를 통해 가져온 경로만 열거합니다. - RTM_ONLY_THIS_PROTOCOL
CriteriaRoute가 가리키는 구조체의 RR_RoutingProtocol 필드에 지정된 라우팅 프로토콜에 의해 추가된 경로만 열거합니다. - RTM_ONLY_BEST_ROUTES
집합의 각 네트워크에 대한 최상의 경로만 열거합니다. -
CriteriaRoute [in]
-
프로토콜 패밀리별 경로 구조(RTM_IP_ROUTE 또는 RTM_IPX_ROUTE )에 대한 포인터입니다. 이 구조체의 멤버 값은 EnumerationFlags 매개 변수에 지정된 플래그에 해당합니다.
반환 값
함수가 성공하면 반환 값은 후속 열거형 호출에 사용할 HANDLE 입니다.
함수가 실패하거나 지정된 조건을 가진 경로가 없는 경우 반환 값은 NULL입니다. GetLastError를 호출하여 자세한 정보를 가져옵니다.
| 값 | 설명 |
|---|---|
|
지정된 조건이 있는 경로가 없습니다. |
|
하나 이상의 입력 매개 변수가 잘못되었습니다(예: 알 수 없는 프로토콜 패밀리, 잘못된 열거형 플래그). |
|
작업을 수행할 리소스가 부족합니다. |
|
핸들을 할당할 메모리가 부족합니다. |
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
지원되는 버전 없음 |
| 지원되는 최소 서버 |
Windows 2000 Server[데스크톱 앱만] |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 라이브러리 |
|
| DLL |
|