RtmCreateNextHopEnum 함수(rtmv2.h)

RtmCreateNextHopEnum은 다음 홉 목록에서 다음 홉을 열거합니다.

구문

DWORD RtmCreateNextHopEnum(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_ENUM_FLAGS    EnumFlags,
  [in]  PRTM_NET_ADDRESS  NetAddress,
  [out] PRTM_ENUM_HANDLE  RtmEnumHandle
);

매개 변수

[in] RtmRegHandle

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

[in] EnumFlags

열거형에 포함할 다음 홉을 지정합니다. 다음 플래그가 사용됩니다.

상수	의미
RTM_ENUM_NEXT	지정된 주소/마스크 길이(예: 10/8)에서 시작하는 다음 홉을 열거합니다. 열거형은 다음 홉 목록의 끝까지 계속됩니다.
RTM_ENUM_RANGE	주소/마스크 길이(예: 10/8)로 지정된 범위에서 다음 홉을 열거합니다.
RTM_ENUM_START	0/0부터 다음 홉을 열거합니다. NetAddress에 NULL을 지정합니다.

[in] NetAddress

열거형의 시작 주소를 포함하는 RTM_NET_ADDRESS 구조체에 대한 포인터입니다. EnumFlags에 RTM_ENUM_START 포함되어 있으면 NULL을 지정합니다.

[out] RtmEnumHandle

입력 시 RtmEnumHandle 은 NULL에 대한 포인터입니다.

출력 시 RtmEnumHandle 은 열거형에 대한 핸들에 대한 포인터를 받습니다. RtmGetEnumNextHops, RtmReleaseNextHops 및 RtmDeleteEnumHandle 에 대한 모든 후속 호출에서 이 핸들을 사용합니다.

반환 값

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

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

값	의미
ERROR_INVALID_PARAMETER	매개 변수에 잘못된 정보가 포함되어 있습니다.
ERROR_NOT_ENOUGH_MEMORY	메모리가 부족하여 이 작업을 완료할 수 없습니다.

설명

EnumFlags에 RTM_ENUM_RANGE 포함된 경우 NetAddress를 사용하여 열거할 라우팅 테이블의 범위를 지정합니다. 예를 들어 클라이언트가 NetAddress 를 10/8로 설정하면 10.0.0.0/8에서 10.255.255.255/32 범위의 다음 홉이 반환됩니다.

열거형 핸들이 더 이상 필요하지 않으면 RtmDeleteEnumHandle을 호출하여 해제합니다.

요구 사항


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