RtmReferenceHandles 함수(rtmv2.h)

RtmReferenceHandles 함수는 라우팅 관리자가 해당 개체에 액세스하는 데 사용한 하나 이상의 핸들이 가리키는 개체에 대한 참조 수를 늘입니다. 클라이언트가 핸들을 유지해야 하지만 핸들과 연결된 나머지 정보 구조를 해제해야 하는 경우 클라이언트는 이 함수를 사용해야 합니다.

구문

DWORD RtmReferenceHandles(
  [in] RTM_ENTITY_HANDLE RtmRegHandle,
  [in] UINT              NumHandles,
  [in] HANDLE            *RtmHandles
);

매개 변수

[in] RtmRegHandle

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

[in] NumHandles

RtmHandles의 핸들 수를 지정합니다.

[in] RtmHandles

참조 횟수를 늘릴 핸들의 배열입니다.

반환 값

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

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

설명

라우팅 테이블 관리자에서 반환된 핸들을 캐싱할 때 클라이언트는 항상 이 함수를 호출해야 합니다. 이렇게 하면 클라이언트에서 핸들을 해제할 때까지 핸들이 참조하는 개체를 삭제해서는 안 됨을 라우팅 테이블 관리자에게 알 수 있습니다.

클라이언트가 핸들을 해제해야 하는 경우 클라이언트는 핸들 유형에 따라 적절한 릴리스 함수를 호출해야 합니다. 예를 들어 경로를 해제하려면 RtmReleaseRoutes를 호출합니다.

요구 사항

추가 정보

RtmDeleteEnumHandle

RtmReleaseChangedDests

RtmReleaseDestInfo

RtmReleaseEntityInfo

RtmReleaseNextHopInfo

RtmReleaseRouteInfo