RtmCreateRouteListEnum 함수(rtmv2.h)

RtmCreateRouteListEnum 함수는 지정된 경로 목록에 경로의 열거형을 만듭니다.

구문

DWORD RtmCreateRouteListEnum(
  [in]  RTM_ENTITY_HANDLE     RtmRegHandle,
  [in]  RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [out] PRTM_ENUM_HANDLE      RtmEnumHandle
);

매개 변수

[in] RtmRegHandle

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

[in] RouteListHandle

RtmCreateRouteList에 대한 이전 호출에서 가져온 열거할 경로 목록에 대한 핸들입니다.

[out] RtmEnumHandle

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

출력 시 RtmEnumHandle 은 열거형에 대한 핸들에 대한 포인터를 받습니다. 경로 목록을 열거하는 함수에 대한 모든 후속 호출에서 이 핸들을 사용합니다.

반환 값

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

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

설명

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

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

요구 사항

추가 정보

RtmDeleteEnumHandle

RtmGetListEnumRoutes