RtmGetListEnumRoutes 함수(rtmv2.h)

RtmGetListEnumRoutes 함수는 지정된 경로 목록의 경로 집합을 열거합니다.

구문

DWORD RtmGetListEnumRoutes(
  [in]      RTM_ENTITY_HANDLE RtmRegHandle,
  [in]      RTM_ENUM_HANDLE   EnumHandle,
  [in, out] PUINT             NumRoutes,
  [out]     PRTM_ROUTE_HANDLE RouteHandles
);

매개 변수

[in] RtmRegHandle

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

[in] EnumHandle

열거할 경로 목록에 대한 핸들입니다.

[in, out] NumRoutes

입력에서 NumRoutes는 RouteHandles에서 수신할 수 있는 최대 경로 수를 지정하는 UINT 값에 대한 포인터입니다.

출력에서 NumRoutes 는 RouteHandles에서 받은 실제 경로 수를 받습니다.

[out] RouteHandles

입력에서 DestInfo 는 RTM_DEST_INFO 구조체 배열에 대한 포인터입니다.

출력에서 DestInfo 는 요청된 대상 정보로 채워집니다.

반환 값

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

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

설명

이 함수를 반복적으로 호출하여 모든 경로를 검색합니다.

라우팅 테이블 관리자가 NumRoutes에서 0을 반환할 때 열거할 경로가 더 이상 없습니다.

이 함수를 사용하는 샘플 코드 는 Client-Specific 경로 목록 사용을 참조하세요.

요구 사항

추가 정보

RtmCreateRouteListEnum

RtmDeleteEnumHandle