RtmGetMostSpecificDestination 함수(rtmv2.h)

RtmGetMostSpecificDestination 함수는 라우팅 테이블에서 지정된 네트워크 주소 및 서브넷 마스크와 정확히 일치하는 대상을 검색합니다. 정확한 일치 항목을 찾을 수 없으면 최상의 접두사는 일치합니다. 대상 정보가 반환됩니다.

구문

DWORD RtmGetMostSpecificDestination(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  PRTM_NET_ADDRESS  DestAddress,
  [in]  ULONG             ProtocolId,
  [in]  RTM_VIEW_SET      TargetViews,
  [out] PRTM_DEST_INFO    DestInfo
);

매개 변수

[in] RtmRegHandle

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

[in] DestAddress

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

[in] ProtocolId

프로토콜 식별자를 지정합니다. ProtocolID는 검색 조건의 일부가 아닙니다. 라우팅 테이블 관리자는 이 식별자를 사용하여 반환할 경로 정보를 결정합니다. 예를 들어 클라이언트가 RIP 프로토콜 식별자를 지정하는 경우 RIP가 아닌 경로가 대상에 가장 적합한 경로인 경우에도 최상의 RIP 경로가 반환됩니다.

경로를 소유하는 프로토콜에 관계없이 경로를 반환할 RTM_BEST_PROTOCOL 지정합니다. 호출 프로토콜에 가장 적합한 경로를 반환하려면 RTM_THIS_PROTOCOL 지정합니다.

[in] TargetViews

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

[out] DestInfo

입력에서 DestInfo 는 RTM_DEST_INFO 구조체에 대한 포인터입니다.

출력에서 DestInfo 는 요청된 대상 정보로 채워집니다.

반환 값

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

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

설명

DestInfo 구조체는 가변 크기 구조체입니다. 클라이언트가 TargetViews를 사용하여 둘 이상의 보기를 지정하는 경우 각 보기에 대해 DestInfo 크기가 증가합니다. 이 함수를 호출하기 전에 RTM_SIZE_OF_DEST_INFO 매크로를 사용하여 DestInfo 구조에 할당할 메모리 양을 결정합니다. TargetViews에 지정된 값을 매개 변수로 사용하여 RTM_SIZE_OF_DEST_INFO.

이 함수를 사용하는 샘플 코드는 접두사 트리를 사용하여 경로 검색을 참조하세요.

요구 사항

추가 정보

RTM_DEST_INFO

RTM_NET_ADDRESS

RtmGetExactMatchDestination

RtmGetExactMatchRoute

RtmGetLessSpecificDestination

RtmIsBestRoute