(mgm.h) PMGM_CREATION_ALERT_CALLBACK 回呼函式
PMGM_CREATION_ALERT_CALLBACK回呼是路由通訊協定的呼叫。 此呼叫會決定路由通訊協定所擁有的介面子集，而路由通訊協議應該從新來源轉送多播封包。
從新來源傳送或以新群組為目標的封包抵達介面時，多播群組管理員會建立新的 MFE。 多播群組管理員接著會叫用此回呼給在此新 MFE 中具有傳出介面的路由通訊協定。 路由通訊協定可以選擇停用將數據從來源轉送至特定介面上的群組。
語法
PMGM_CREATION_ALERT_CALLBACK PmgmCreationAlertCallback;
DWORD PmgmCreationAlertCallback(
[in] DWORD dwSourceAddr,
[in] DWORD dwSourceMask,
[in] DWORD dwGroupAddr,
[in] DWORD dwGroupMask,
[in] DWORD dwInIfIndex,
[in] DWORD dwInIfNextHopAddr,
[in] DWORD dwIfCount,
[in, out] PMGM_IF_ENTRY pmieOutIfList
)
{...}
參數
[in] dwSourceAddr
指定接收多播數據的來源位址。 零表示從所有來源接收數據， (群組的通配符接收者) ;否則， dwSourceAddr 的值是來源或來源網路的IP位址。
若要指定來源位址的範圍，多播群組管理員會使用 dwSourceAddr 指定來源網路，並使用 dwSourceMask 指定子網掩碼。
[in] dwSourceMask
指定對應至 dwSourceAddr 的子網掩碼。 dwSourceAddr 和 dwSourceMask 參數會一起使用，以定義接收多播數據的來源範圍。
如果多播群組管理員也針對 dwSourceAddr (通配符接收器) 指定零，則此參數會指定零。
[in] dwGroupAddr
指定數據目的地的多播群組。 零表示在通配符接收者) (收到所有群組;否則， dwGroupAddr 的值是群組的IP位址。
若要指定群組位址的範圍，多播群組管理員會使用 dwGroupAddr 指定群組位址，並使用 dwGroupMask 指定子網掩碼。
[in] dwGroupMask
指定對應至 dwGroupAddr 的子網掩碼。 dwGroupAddr 和 dwGroupMask 參數會一起使用來定義多播群組的範圍。
如果多播群組管理員也為 dwGroupAddr 指定零， (通配符接收者) ，則此參數會指定零。
[in] dwInIfIndex
指定來源的多播數據應該抵達的介面。
[in] dwInIfNextHopAddr
指定對應至 dwIfIndex 所指定索引的下一個躍點位址。 dwIfIndex 和 dwIfNextHopIPAddr 參數可唯一識別點對多點介面上的下一個躍點。 點對多點介面是一個連接，其中一個介面會連線到多個網路。 點對多點介面的範例包括非廣播多重存取 (NBMA) 介面，以及所有撥號用戶端連線的內部介面。
對於廣播介面 (，例如乙太網路介面) 或點對點介面，只有 dwIfIndex 的值識別，請指定零。
[in] dwIfCount
指定 pmieOutIfList 所指向緩衝區中的介面數目。
[in, out] pmieOutIfList
在輸入時，緩衝區的指標，其中包含將轉送數據之通訊協定所擁有的介面集。
在輸出時，用戶端可以將對應MGM_IF_ENTRY結構的 bIsEnabled 成員設定為 FALSE，以防止在任何介面上進行轉送。 可能不需要用戶端才能防止轉送;這類用戶端會接受 bIsEnabled 的預設值。
傳回值
RRAS 不預期應用程式會傳回任何特定值;RRAS 會忽略傳回的任何值。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mgm.h |