RtmGetFirstRoute 함수

[이 API는 라우팅 테이블 관리자 버전 2 API로 대체되었으며 Windows Server 2003 이후로는 사용할 수 없습니다. 애플리케이션은 라우팅 테이블 관리자 버전 2 API를 사용해야 합니다.]

RtmGetFirstRoute 함수는 테이블의 지정된 경로 하위 집합에서 첫 번째 경로를 반환합니다.

구문

DWORD RtmGetFirstRoute(
  _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.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

경로는 다음 순서로 반환됩니다.

이 함수는 해당 열거형 핸들 함수인 RtmEnumerateGetNextRoute보다 효율성이 떨어집니다.

이 페이지가 도움이 되었나요?