RtmGetExactMatchRoute 함수(rtmv2.h)

RtmGetExactMatchRoute 함수는 라우팅 테이블에서 지정된 경로와 정확히 일치하는 경로를 검색합니다. 검색할 경로는 네트워크 주소, 서브넷 마스크 및 기타 경로 일치 조건으로 표시됩니다. 정확한 일치 항목이 발견되면 경로 정보가 반환됩니다.

구문

DWORD RtmGetExactMatchRoute(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      PRTM_NET_ADDRESS  DestAddress,
  [in]      RTM_MATCH_FLAGS   MatchingFlags,
  [in, out] PRTM_ROUTE_INFO   RouteInfo,
  [in]      ULONG             InterfaceIndex,
  [in]      RTM_VIEW_SET      TargetViews,
  [out]     PRTM_ROUTE_HANDLE RouteHandle
);

매개 변수

[in] RtmRegHandle

RtmRegisterEntity에 대한 이전 호출에서 얻은 클라이언트에 대한 핸들입니다.

[in] DestAddress

대상 네트워크 주소에 대한 포인터입니다.

[in] MatchingFlags

경로를 검색할 때 사용할 조건을 지정합니다. 다음 플래그가 사용됩니다.

[in, out] RouteInfo

입력에서 RouteInfo 는 찾을 경로를 지정하는 조건을 포함하는 RTM_ROUTE_INFO 구조체를 가리키는 포인터입니다.

출력에서 RouteInfo 는 조건과 일치하는 경로에 대한 경로 정보를 받습니다.

[in] InterfaceIndex

RTM_MATCH_INTERFACE MatchingFlags에 지정된 경우 InterfaceIndex는 경로가 있어야 하는 인터페이스를 지정합니다(즉, 경로에 해당 인터페이스에 다음 홉이 있음).

[in] TargetViews

정보를 반환할 뷰를 지정합니다. 클라이언트가 RTM_VIEW_MASK_ANY 지정하면 모든 보기에서 대상 정보가 반환됩니다. 그러나 뷰별 정보는 반환되지 않습니다.

[out] RouteHandle

핸들을 반환해야 하는 경우: 입력에서 RouteHandle 은 NULL에 대한 포인터입니다.

출력 시 RouteHandle 은 경로 핸들에 대한 포인터를 받습니다. 그렇지 않으면 RouteHandle은 변경되지 않은 상태로 유지됩니다.

핸들을 반환할 필요가 없는 경우: 입력에서 RouteHandle 은 NULL입니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

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

설명

MatchingFlags 매개 변수에 지정된 경로 일치 조건이 없는 경우 RtmGetExactMatchDestination을 사용하는 것이 좋습니다.

RouteInfo 매개 변수에 전달되는 RTM_ROUTE_INFO 구조체의 다음 멤버는 경로와 일치하는 데 사용됩니다.

• 이웃
• NextHopsList
• PrefInfo
• RouteOwner

요구 사항

추가 정보

RTM_NET_ADDRESS

RTM_ROUTE_INFO

RtmGetExactMatchDestination

RtmGetLessSpecificDestination

RtmGetMostSpecificDestination

RtmIsBestRoute