RtmGetDestInfo 함수(rtmv2.h)

RtmGetDestInfo 함수는 대상에 대한 정보를 반환합니다.

구문

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

RtmReleaseDestInfo를 사용하여 DestInfo 버퍼를 해제합니다.

요구 사항

추가 정보

RTM_DEST_INFO

RtmReleaseDestInfo