RtmFindNextHop 함수(rtmv2.h)

RtmFindNextHop 함수는 클라이언트의 다음 홉 목록에서 특정 다음 홉을 찾습니다.

구문

DWORD RtmFindNextHop(
  [in]  RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]  PRTM_NEXTHOP_INFO   NextHopInfo,
  [out] PRTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO   *NextHopPointer
);

매개 변수

[in] RtmRegHandle

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

[in] NextHopInfo

찾을 다음 홉을 식별하는 정보가 포함된 RTM_NEXTHOP_INFO 구조체에 대한 포인터입니다. NextHopAddress 및 InterfaceIndex 멤버를 사용하여 찾을 다음 홉을 식별합니다.

[out] NextHopHandle

핸들을 반환해야 하는 경우: 입력에서 NextHopPointer 는 NULL에 대한 포인터입니다. 출력에서 클라이언트가 다음 홉을 소유하는 경우 NextHopPointer 는 다음 홉 핸들에 대한 포인터를 받습니다. 그렇지 않으면 NextHopPointer는 변경되지 않은 상태로 유지됩니다.

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

[out] NextHopPointer

포인터를 반환해야 하는 경우: 입력에서 NextHopPointer 는 NULL에 대한 포인터입니다. 출력에서 클라이언트가 다음 홉을 소유하는 경우 NextHopPointer 는 다음 홉에 대한 포인터를 받습니다. 그렇지 않으면 NextHopPointer는 변경되지 않은 상태로 유지됩니다.

포인터를 반환할 필요가 없는 경우: 입력에서 NextHopPointer 는 NULL입니다.

반환 값

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

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

설명

NextHopPointer는 클라이언트가 NextHopHandle을 릴리스하지 않은 한 유효합니다.

요구 사항

추가 정보

RTM_NEXTHOP_INFO

RtmAddNextHop

RtmDeleteNextHop

RtmGetNextHopPointer

RtmLockNextHop