RtmLockNextHop 함수(rtmv2.h)
RtmLockNextHop 함수는 다음 홉을 잠그거나 잠금을 해제합니다. 다음 홉을 변경하기 전에 다음 홉의 소유자가 다음 홉을 잠그도록 이 함수를 호출해야 합니다. 다음 홉에 대한 포인터가 반환됩니다.
구문
DWORD RtmLockNextHop(
[in] RTM_ENTITY_HANDLE RtmRegHandle,
[in] RTM_NEXTHOP_HANDLE NextHopHandle,
[in] BOOL Exclusive,
[in] BOOL LockNextHop,
[out] PRTM_NEXTHOP_INFO *NextHopPointer
);
매개 변수
[in] RtmRegHandle
RtmRegisterEntity에 대한 이전 호출에서 얻은 클라이언트에 대한 핸들입니다.
[in] NextHopHandle
잠금 또는 잠금 해제를 위한 다음 홉에 대한 핸들입니다.
[in] Exclusive
배타적(TRUE) 또는 공유(FALSE) 모드에서 다음 홉을 잠그거나 잠금 해제할지 여부를 지정합니다.
[in] LockNextHop
다음 홉을 잠그거나 잠금 해제할지 여부를 지정합니다. 다음 홉을 잠그려면 TRUE 를 지정합니다. FALSE를 지정하여 잠금을 해제합니다.
[out] NextHopPointer
입력에서 NextHopPointer 는 NULL에 대한 포인터입니다.
출력에서 클라이언트가 다음 홉을 소유하는 경우 NextHopPointer 는 다음 홉에 대한 포인터를 받습니다. 그렇지 않으면 NextHopPointer는 변경되지 않은 상태로 유지됩니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
값 | 의미 |
---|---|
|
호출 클라이언트는 다음 홉을 소유하지 않습니다. |
|
지정된 다음 홉을 찾을 수 없습니다. |
설명
클라이언트는 RTM_NEXTHOP_INFO 구조체의 NextHopAddress 및 InterfaceIndex 멤버를 변경할 수 없습니다. 이러한 값은 다음 홉을 고유하게 식별하는 데 사용됩니다.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | 지원되는 버전 없음 |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | rtmv2.h |
라이브러리 | Rtm.lib |
DLL | Rtm.dll |
추가 정보
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기