RtmGetLessSpecificDestination 함수(rtmv2.h)

RtmGetLessSpecificDestination 함수는 대상 접두사로 지정된 다음 최적 일치(가장 긴) 접두사를 사용하여 라우팅 테이블에서 대상을 검색합니다. 요청된 대상 정보가 반환됩니다.

구문

DWORD RtmGetLessSpecificDestination(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [in]  ULONG             ProtocolId,
  [in]  RTM_VIEW_SET      TargetViews,
  [out] PRTM_DEST_INFO    DestInfo
);

매개 변수

[in] RtmRegHandle

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

[in] DestHandle

대상에 대한 핸들입니다.

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

RtmGetLessSpecificDestination 함수는 RtmGetMostSpecificDestination을 호출한 후 대상에 대한 다음 일치 항목을 반환하는 데 사용됩니다. 이 호출은 RtmGetLessSpecificDestination에 대한 이전 호출 후에도 사용되어 덜 구체적인 다음 일치 항목을 반환합니다. 클라이언트는 이 함수를 사용하여 대상의 접두사 트리를 "위로"할 수 있습니다.

이 호출은 RtmGetDestInfo 및 RtmGetChangedDests와 같은 RTM_DEST_INFO 구조를 반환하는 함수를 호출한 후에도 사용됩니다.

RtmGetLessSpecificDestination 함수는 기본 경로(있는 경우)에 도달할 때까지 일치 항목을 반환합니다. 기본 경로가 발견되면 RtmGetLessSpecificDestination 은 ERROR_NOT_FOUND 반환합니다.

RtmGetLessSpecificDestination 및 RtmGetMostSpecificDestination 함수에 대한 일반적인 용도 중 하나는 일치하는 각 대상을 검색하는 것입니다.

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

요구 사항

추가 정보

RTM_DEST_INFO

RtmGetExactMatchDestination

RtmGetExactMatchRoute

RtmGetMostSpecificDestination

RtmIsBestRoute