RtmGetExactMatchDestination 함수(rtmv2.h)

RtmGetExactMatchDestination 함수는 라우팅 테이블에서 지정된 네트워크 주소 및 서브넷 마스크와 정확히 일치하는 대상을 검색합니다. 정확히 일치하는 항목이 발견되면 해당 대상에 대한 정보가 반환됩니다.

구문

DWORD RtmGetExactMatchDestination(
  [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

RtmGetExactMatchRoute

RtmGetLessSpecificDestination

RtmGetMostSpecificDestination

RtmIsBestRoute