RtmAddNextHop 함수(rtmv2.h)

아티클
08/25/2023

RtmAddNextHop 함수는 새 다음 홉 항목을 추가하거나 클라이언트의 다음 홉 목록에 기존 다음 홉 항목을 업데이트합니다. 다음 홉이 이미 있는 경우 라우팅 테이블 관리자는 다음 홉에 대한 핸들을 반환합니다. 그런 다음 이 핸들을 사용하여 경로를 추가하거나 업데이트할 때 대상에 대한 다음 홉을 지정할 수 있습니다.

구문

DWORD RtmAddNextHop(
  [in]      RTM_ENTITY_HANDLE         RtmRegHandle,
  [in]      PRTM_NEXTHOP_INFO         NextHopInfo,
  [in, out] PRTM_NEXTHOP_HANDLE       NextHopHandle,
  [out]     PRTM_NEXTHOP_CHANGE_FLAGS ChangeFlags
);

매개 변수

[in] RtmRegHandle

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

[in] NextHopInfo

추가하거나 업데이트할 다음 홉을 식별하는 정보가 포함된 구조체에 대한 포인터입니다. NextHopOwner 및 State 멤버는 무시됩니다. 이러한 멤버는 라우팅 테이블 관리자에 의해 설정됩니다. Flags 멤버는 다음 값 중 하나일 수 있습니다.

플래그	의미
RTM_NEXTHOP_FLAGS_REMOTE	다음 홉은 직접 연결할 수 없는 원격 대상을 가리킵니다. 전체 경로를 가져오려면 클라이언트가 재귀 조회를 수행해야 합니다.
RTM_NEXTHOP_FLAGS_DOWN	이 플래그는 나중에 사용하도록 예약되어 있습니다.

[in, out] NextHopHandle

클라이언트에 핸들이 있는 경우(클라이언트가 다음 홉을 업데이트하는 경우): 입력에서 NextHopHandle 은 다음 홉 핸들에 대한 포인터입니다. 출력에서 NextHopHandle 은 변경되지 않습니다.

클라이언트에 핸들이 없으며 핸들을 반환해야 하는 경우(클라이언트가 다음 홉을 추가하거나 업데이트하는 경우): 입력에서 NextHopHandle 은 NULL에 대한 포인터입니다. 출력에서 NextHopHandle 은 다음 홉 핸들에 대한 포인터를 받습니다. NextHopInfo의 값은 업데이트할 다음 홉을 식별하는 데 사용됩니다.

핸들을 반환할 필요가 없는 경우(클라이언트가 다음 홉을 추가하거나 업데이트하는 경우): 입력에서 NextHopHandle 은 NULL입니다. NextHopInfo의 값은 업데이트할 다음 홉을 식별하는 데 사용됩니다.

[out] ChangeFlags

입력 시 ChangeFlags 는 RTM_NEXTHOP_CHANGE_FLAGS 데이터 형식에 대한 포인터입니다.

출력 시 ChangeFlags 는 다음 홉이 추가 또는 업데이트되었는지 여부를 나타내는 플래그를 받습니다. ChangeFlags가 0이면 다음 홉이 업데이트되었습니다. ChangeFlags가 RTM_NEXTHOP_CHANGE_NEW 다음 홉이 추가되었습니다.

반환 값

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

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

값	의미
ERROR_ACCESS_DENIED	호출 클라이언트는 다음 홉을 소유하지 않습니다.
ERROR_NOT_ENOUGH_MEMORY	메모리가 부족하여 이 작업을 완료할 수 없습니다.

설명

NextHopHandle이 NULL이 아닌 핸들을 가리키는 경우 핸들에 지정된 다음 홉이 업데이트됩니다. 그렇지 않으면 NextHopInfo에서 지정한 주소에 대한 검색이 이루어집니다. 다음 홉이 발견되면 업데이트됩니다. 일치하는 항목이 없으면 새 다음 홉이 추가됩니다.

핸들이 반환된 경우 RtmReleaseNextHops를 호출하여 더 이상 필요하지 않은 경우 핸들을 해제합니다.

요구 사항


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