MgmGetProtocolOnInterface 함수(mgm.h)

MgmGetProtocolOnInterface 함수는 지정된 인터페이스를 소유하는 멀티캐스트 라우팅 프로토콜의 프로토콜 ID를 검색합니다.

구문

DWORD MgmGetProtocolOnInterface(
  [in]      DWORD  dwIfIndex,
  [in]      DWORD  dwIfNextHopAddr,
  [in, out] PDWORD pdwIfProtocolId,
  [in, out] PDWORD pdwIfComponentId
);

매개 변수

[in] dwIfIndex

프로토콜 ID를 검색할 인터페이스의 인덱스를 지정합니다.

[in] dwIfNextHopAddr

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

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

[in, out] pdwIfProtocolId

입력 시 클라이언트는 DWORD 크기의 메모리 위치에 대한 포인터를 제공해야 합니다.

출력 시 pdwIfProtocolId 는 dwIfIndex로 지정된 인터페이스에서 프로토콜의 ID를 받습니다.

[in, out] pdwIfComponentId

입력 시 클라이언트는 DWORD 값에 대한 포인터를 제공해야 합니다.

출력 시 pdwIfComponentId는 인터페이스에서 프로토콜의 instance 대한 구성 요소 ID를 받습니다. 이 매개 변수는 pdwIfProtocolId와 함께 라우팅 프로토콜의 instance 고유하게 식별하는 데 사용됩니다.

반환 값

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

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

값	의미
ERROR_CAN_NOT_COMPLETE	이 함수에 대한 호출을 완료할 수 없습니다.
ERROR_NOT_FOUND	멀티캐스트 그룹 관리자가 지정한 인터페이스를 찾을 수 없습니다.

 

 

요구 사항

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

추가 정보

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership