RtmGetEnumNextHops 함수(rtmv2.h)

RtmGetEnumNextHops 함수는 지정된 열거형에서 다음 홉 집합을 검색합니다.

구문

DWORD RtmGetEnumNextHops(
  [in]      RTM_ENTITY_HANDLE   RtmRegHandle,
  [in]      RTM_ENUM_HANDLE     EnumHandle,
  [in, out] PUINT               NumNextHops,
  [out]     PRTM_NEXTHOP_HANDLE NextHopHandles
);

매개 변수

[in] RtmRegHandle

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

[in] EnumHandle

다음 홉 열거형에 대한 핸들입니다.

[in, out] NumNextHops

입력 시 NumNextHops는 NextHopHandles에서 수신할 수 있는 다음 홉의 최대 수를 지정하는 UINT 값에 대한 포인터입니다.

출력에서 NumNextHops 는 NextHopHandles에서 받은 다음 홉의 실제 수를 받습니다.

[out] NextHopHandles

입력에서 NextHopHandles 는 RTM_NEXTHOP_INFO 구조체에 대한 포인터를 반환합니다.

출력에서 NextHopHandles 는 다음 홉에 대한 핸들 배열을 받습니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	NumRoutes가 가리키는 값은 클라이언트가 한 번의 호출로 검색할 수 있는 최대 경로 수보다 큽니다. RTM_REGN_PROFILE 클라이언트가 한 번의 호출로 검색할 수 있는 최대 다음 홉 수를 확인합니다.
ERROR_NO_MORE_ITEMS	열거할 다음 홉은 더 이상 없습니다.

설명

다음 홉이 더 이상 필요하지 않으면 RtmReleaseNextHops를 호출하여 해제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	rtmv2.h
라이브러리	Rtm.lib
DLL	Rtm.dll