PGET_MFE_STATUS回呼函式 (routprot.h)

路由器管理員會呼叫 GetMfeStatus 函式，以取得指定介面、群組位址和來源位址之多播轉送專案的狀態 (MFE) 。

PGET_MFE_STATUS類型會定義這個回呼函式的指標。 GetMfeStatus 是應用程式定義函數名稱的佔位元。

語法

PGET_MFE_STATUS PgetMfeStatus;

DWORD PgetMfeStatus(
  [in]  DWORD InterfaceIndex,
  [in]  DWORD GroupAddress,
  [in]  DWORD SourceAddress,
  [out] PBYTE StatusCode
)
{...}

參數

[in] InterfaceIndex

指定這個 MFE 介面的索引。

[in] GroupAddress

指定這個 MFE 的多播群組位址。

[in] SourceAddress

指定這個 MFE 的多播來源位址。

[out] StatusCode

BYTE 變數的指標。 路由通訊協議應該會以下列其中一個值填入此變數。 路由通訊協定應選取套用的最高值程序代碼。

值	意義
MFE_NO_ERROR	不適用下列任何值。
MFE_REACHED_CORE	此路由器上的本機計算機是多播群組 (RP) /core 路由器的交集點。
MFE_OIF_PRUNED	此值只能由傳出介面的擁有者設定。 值表示傳出介面上沒有任何下游接收者存在。
MFE_PRUNED_UPSTREAM	此值只能由傳入介面的擁有者設定。 值表示已傳送上游剪除訊息。
MFE_OLD_ROUTER	此值只能由傳入介面的擁有者設定。 值表示上游芳鄰不支援 mtrace。

傳回值

如果函式成功，則傳回值應該NO_ERROR。

如果函式失敗，傳回值應該是下列其中一個錯誤碼。

值	Description
ERROR_CAN_NOT_COMPLETE	路由通訊協議無法完成要求。
ERROR_INVALID_PARAMETER	InterfaceIndex 參數無效 (例如，該索引) 沒有任何介面存在，或群組或來源地址無效。

 

 

備註

只有多播路由通訊協定需要實作此函式。 非多播路由通訊協議應該在 MPR_ROUTING_CHARACTERISTICS 中傳遞NULL 作為此函式的指標值

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	routprot.h

另請參閱

GetNeigbeers