RtmInsertInRouteList 함수(rtmv2.h)

RtmInsertInRouteList 함수는 지정된 경로 집합을 클라이언트의 경로 목록에 삽입합니다. 경로가 이미 다른 목록에 있는 경우 경로가 이전 목록에서 제거되고 새 목록에 삽입됩니다.

구문

DWORD RtmInsertInRouteList(
  [in] RTM_ENTITY_HANDLE     RtmRegHandle,
  [in] RTM_ROUTE_LIST_HANDLE RouteListHandle,
  [in] UINT                  NumRoutes,
  [in] PRTM_ROUTE_HANDLE     RouteHandles
);

매개 변수

[in] RtmRegHandle

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

[in] RouteListHandle

경로를 추가할 경로 목록에 대한 핸들입니다. NULL을 지정하여 이전 목록에서 지정된 경로를 제거합니다.

[in] NumRoutes

RouteHandles의 경로 수를 지정합니다.

[in] RouteHandles

이전 목록에서 새 목록으로 이동하는 경로 핸들 배열에 대한 포인터입니다.

반환 값

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

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

설명

경로가 더 이상 필요하지 않으면 RtmReleaseRoutes를 호출하여 해제합니다.

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

요구 사항

추가 정보

RtmCreateRouteList

RtmDeleteRouteList