MgmTakeInterfaceOwnership 함수(mgm.h)

MgmTakeInterfaceOwnership 함수는 인터페이스에서 사용하도록 설정된 경우 클라이언트(예: 라우팅 프로토콜)에 의해 호출됩니다.

한 클라이언트만 언제든지 지정된 인터페이스의 소유권을 가져올 수 있습니다. 이 규칙의 유일한 예외는 IGMP입니다. IGMP는 인터페이스에서 다른 클라이언트와 공존할 수 있습니다.

구문

DWORD MgmTakeInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

매개 변수

[in] hProtocol

MgmRegisterMProtocol에 대한 이전 호출에서 얻은 프로토콜에 대한 핸들입니다.

[in] dwIfIndex

소유권을 가져올 인터페이스의 인덱스를 지정합니다.

[in] dwIfNextHopAddr

dwIfIndex에서 지정한 인덱스에 해당하는 다음 홉의 주소를 지정합니다. dwIfIndex 및 dwIfNextHopIPAddr 매개 변수는 지점 간 인터페이스에서 다음 홉을 고유하게 식별합니다. 지점 및 다중 지점 인터페이스는 하나의 인터페이스가 여러 네트워크에 연결되는 연결입니다. 지점 및 다중 지점 인터페이스의 예로는 NBMA(비 브로드캐스트 다중 액세스) 인터페이스 및 모든 전화 접속 클라이언트가 연결하는 내부 인터페이스가 있습니다.

dwIfIndex 값으로만 식별되는 브로드캐스트 인터페이스(예: 이더넷 인터페이스) 또는 지점 및 지점 인터페이스의 경우 0을 지정합니다.

반환 값

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

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

값	의미
ERROR_ALREADY_EXISTS	지정된 인터페이스는 이미 다른 라우팅 프로토콜에서 소유하고 있습니다.
ERROR_CAN_NOT_COMPLETE	이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_INVALID_PARAMETER	클라이언트에 대한 핸들이 잘못되었습니다.
ERROR_NOT_ENOUGH_MEMORY	메모리가 부족하여 이 작업을 완료할 수 없습니다.

 

 

설명

클라이언트는 멀티캐스트 그룹 관리자에 등록한 후에만 인터페이스의 소유권을 가져와야 하지만 그룹 멤버 자격 항목을 추가하기 전에 해당 인터페이스를 소유해야 합니다.

요구 사항

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

추가 정보

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership