MgmDeleteGroupMembershipEntry 함수(mgm.h)

  • 아티클

MgmDeleteGroupMembershipEntry 함수는 멀티캐스트 그룹 관리자에게 지정된 인터페이스에 지정된 그룹에 대한 수신기가 더 이상 없음을 알릴 수 있습니다.

멀티캐스트 라우팅 프로토콜은 인터페이스에 멀티캐스트 그룹에 대한 수신기가 더 이상 없다는 알림이 표시되면 이 함수를 호출합니다. 프로토콜은 이 함수를 호출하여 멀티캐스트 데이터가 인터페이스를 통해 전달되지 않도록 해야 합니다.

구문

DWORD MgmDeleteGroupMembershipEntry(
  [in] HANDLE hProtocol,
  [in] DWORD  dwSourceAddr,
  [in] DWORD  dwSourceMask,
  [in] DWORD  dwGroupAddr,
  [in] DWORD  dwGroupMask,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopIPAddr,
  [in] DWORD  dwFlags
);

매개 변수

[in] hProtocol

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

[in] dwSourceAddr

멀티캐스트 데이터 수신을 중지할 원본 주소를 지정합니다. 모든 원본(그룹의 와일드카드 수신기)에서 데이터 수신을 중지하려면 0을 지정합니다. 그렇지 않으면 원본 또는 원본 네트워크의 IP 주소를 지정합니다.

원본 주소 범위를 지정하려면 dwSourceAddr을 사용하여 원본 네트워크를 지정하고 dwSourceMask를 사용하여 서브넷 마스크를 지정합니다.

[in] dwSourceMask

dwSourceAddr에 해당하는 서브넷 마스크를 지정합니다. dwSourceAddr 및 dwSourceMask 매개 변수는 멀티캐스트 데이터 수신을 중지할 원본 범위를 정의하는 데 함께 사용됩니다.

dwSourceAddr(와일드카드 수신기)에 대해 0을 지정한 경우 이 매개 변수에 대해 0을 지정합니다.

[in] dwGroupAddr

데이터 수신을 중지할 멀티캐스트 그룹을 지정합니다. 모든 그룹(와일드카드 수신기)의 수신을 중지하려면 0을 지정합니다. 그렇지 않으면 그룹의 IP 주소를 지정합니다.

그룹 주소 범위를 지정하려면 dwGroupAddr을 사용하여 그룹 주소를 지정하고 dwGroupMask를 사용하여 서브넷 마스크를 지정합니다.

[in] dwGroupMask

dwGroupAddr에 해당하는 서브넷 마스크를 지정합니다. dwGroupAddr 및 dwGroupMask 매개 변수는 멀티캐스트 그룹의 범위를 정의하는 데 함께 사용됩니다.

dwGroupAddr(와일드카드 수신기)에 대해 0을 지정한 경우 이 매개 변수에 대해 0을 지정합니다.

[in] dwIfIndex

그룹 멤버 자격을 삭제할 인터페이스를 지정합니다. 지정된 그룹의 멀티캐스트 데이터는 이 인터페이스를 통해 더 이상 전달되지 않습니다.

[in] dwIfNextHopIPAddr

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

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

[in] dwFlags

그룹 멤버 자격이 제거될 때 수행해야 하는 추가 처리를 지정합니다. 유효한 값은 다음과 같습니다.

값 의미
MGM_JOIN_STATE_FLAG
 지정된 원본 및 그룹에 대한 그룹 멤버 자격을 제거합니다. 지정된 원본 그룹에 대한 전달 항목을 업데이트하여 그룹 멤버 자격 변경 내용을 반영합니다.
MGM_FORWARD_STATE
 지정된 원본 및 그룹에 해당하는 전달 항목의 나가는 인터페이스 목록에서 지정된 인터페이스를 제거합니다.

반환 값

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

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

값 의미
ERROR_CAN_NOT_COMPLETE
 이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_INVALID_PARAMETER
 프로토콜에 대한 핸들이 잘못되었거나 인터페이스가 다른 프로토콜에 의해 소유됩니다.
ERROR_NOT_FOUND
 지정된 인터페이스를 찾을 수 없습니다.
 
 

설명

이 버전의 MGM API는 원본 범위가 아닌 와일드카드 원본 또는 특정 원본만 지원합니다. 동일한 제한이 그룹에 적용됩니다(즉, 그룹 범위가 허용되지 않음).

이 함수가 호출되면 멀티캐스트 그룹 관리자는 PMGM_PRUNE_ALERT_CALLBACK 콜백을 호출하여 다른 라우팅 프로토콜에 지정된 그룹에 대한 수신기가 더 이상 존재하지 않음을 알릴 수 있습니다.

요구 사항

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

추가 정보

MgmAddGroupMembershipEntry

PMGM_PRUNE_ALERT_CALLBACK