RtmGetNextHopPointer 함수(rtmv2.h)

아티클
03/01/2024

RtmGetNextHopPointer 함수는 지정된 다음 홉에 대한 직접 포인터를 가져옵니다. 포인터를 사용하면 다음 홉 소유자가 라우팅 테이블 관리자의 RTM_NEXTHOP_INFO 구조에 직접 읽기 권한을 부여할 수 있습니다.

구문

DWORD RtmGetNextHopPointer(
  [in]  RTM_ENTITY_HANDLE  RtmRegHandle,
  [in]  RTM_NEXTHOP_HANDLE NextHopHandle,
  [out] PRTM_NEXTHOP_INFO  *NextHopPointer
);

매개 변수

[in] RtmRegHandle

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

[in] NextHopHandle

다음 홉에 대한 핸들입니다.

[out] NextHopPointer

클라이언트가 다음 홉의 소유자인 경우 NextHopPointer 는 다음 홉에 대한 포인터를 받습니다.

반환 값

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

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

값	의미
ERROR_ACCESS_DENIED	호출 클라이언트는 이 다음 홉을 소유하지 않습니다.
ERROR_INVALID_HANDLE	핸들이 잘못되었습니다.

설명

클라이언트는 읽기 전용 액세스에만 이 포인터를 사용해야 합니다.

다음 홉 핸들이 더 이상 필요하지 않으면 RtmReleaseNextHopInfo를 호출하여 해제합니다.

요구 사항

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