MgmReleaseInterfaceOwnership 함수(mgm.h)
MgmReleaseInterfaceOwnership 함수는 클라이언트가 인터페이스의 소유권을 포기하는 데 사용됩니다. 이 함수가 호출되면 클라이언트를 대신하여 멀티캐스트 그룹 관리자가 유지 관리하는 모든 MFE와 지정된 인터페이스에 대해 유지 관리되는 모든 MFE가 삭제됩니다.
구문
DWORD MgmReleaseInterfaceOwnership(
[in] HANDLE hProtocol,
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr
);
매개 변수
[in] hProtocol
MgmRegisterMProtocol에 대한 이전 호출에서 가져온 프로토콜에 대한 핸들입니다.
[in] dwIfIndex
해제할 인터페이스의 인덱스를 지정합니다.
[in] dwIfNextHopAddr
dwIfIndex에서 지정한 인덱스에 해당하는 다음 홉의 주소를 지정합니다. dwIfIndex 및 dwIfNextHopIPAddr 매개 변수는 지점 및 다중 지점 인터페이스에서 다음 홉을 고유하게 식별합니다. 지점 및 다중 지점 인터페이스는 하나의 인터페이스가 여러 네트워크에 연결되는 연결입니다. 지점 및 다중 지점 인터페이스의 예로는 NBMA(비 브로드캐스트 다중 액세스) 인터페이스 및 모든 전화 접속 클라이언트가 연결하는 내부 인터페이스가 있습니다.
dwIfIndex 값으로만 식별되는 브로드캐스트 인터페이스(예: 이더넷 인터페이스) 또는 지점 및 지점 인터페이스의 경우 0을 지정합니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR.
함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.
| 값 | 의미 |
|---|---|
|
이 함수에 대한 호출을 완료할 수 없습니다. |
|
클라이언트에 대한 핸들이 잘못되었거나 인터페이스를 찾을 수 없습니다. |
설명
클라이언트는 MgmDeRegisterMProtocol 함수를 사용하여 자체 등록을 취소하기 전에 소유하는 모든 인터페이스의 소유권을 해제해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 지원되는 버전 없음 |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgm.h |
| 라이브러리 | Rtm.lib |
| DLL | Rtm.dll |