mgmGetNextMfeStats 函式 (mgm.h)
MgmGetNextMfeStats 函式會擷取一或多個 MFE 統計數據集。 路由表管理員會從指定的 MFE 之後的 MFE 開始擷取統計數據。 函式可以擷取零、一或多個 MFE 統計數據集。 傳回的集合數目取決於呼叫 函式時，用戶端所提供的專案大小和緩衝區大小。
緩衝區中傳回的數據會先依群組排序，然後再依群組內的來源排序。 傳回的統計數據包括接收的封包、接收的位元組，以及每個傳出介面上轉送的封包。
語法
DWORD MgmGetNextMfeStats(
[in] PMIB_IPMCAST_MFE pimmStart,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries,
DWORD dwFlags
);
參數
[in] pimmStart
指定從何處開始擷取 MFE 統計數據 之MIB_IPMCAST_MFE 結構的指標。 MIB_IPMCAST_MFE 結構的 dwSource 和 dwGroup 成員會識別 MFE。 指定先前呼叫 MgmGetFirstMfeStats 或 MgmGetNextMfeStats 所傳回的最後一個 MFE 來源和群組。
[in, out] pdwBufferSize
在輸入時， pdwBufferSize 是 DWORD 大小的記憶體位置指標，其中包含 pbBuffer 的大小，以位元組為單位。
在輸出中，如果傳回值是ERROR_INSUFFICIENT_BUFFER，pdwBufferSize 會收到最小大小的 pbBuffer 必須是保留一組 MFE 統計數據; 否則，pdwBufferSize 的值會保持不變。
[in, out] pbBuffer
在輸入時，客戶端必須提供緩衝區的指標。
在輸出時， pbBuffer 包含一或多個 MFE 統計數據集。 每一組 MFE 統計數據都是 MIB_IPMCAST_MFE_STATS 結構。
[in, out] pdwNumEntries
在輸入時，客戶端必須提供 DWORD 大小記憶體位置的指標。
在輸出時， pdwNumEntries 會接收 pbBuffer 中包含的 MFE 統計數據集數目。
dwFlags
決定傳回的數據結構。
| 值 | 意義 |
|---|---|
|
包含對應至 MIB_IPMCAST_MFE_STATS的統計數據。 |
|
包含對應至 MIB_IPMCAST_MFE_STATS_EX的統計數據。 |
傳回值
如果函式成功，傳回值會 NO_ERROR。
如果函式失敗，傳回值就是下列其中一個錯誤碼。
| 值 | 意義 |
|---|---|
|
無法完成此函式的呼叫。 |
|
指定的緩衝區太小，即使是一組 MFE 統計數據也太小。 客戶端應該檢查 pdwBufferSize 的值，以取得擷取一組統計數據所需的最小緩衝區大小。 |
|
有更多 MFE 統計數據可供使用。 |
|
不再提供 MFE 統計數據。 傳回零或多個 MFE 統計數據集;請檢查 pdwNumEntries 的值，以確認傳回多少組統計數據。 |
備註
此函式可用來繼續循序擷取 MFE 統計數據;使用 MgmGetFirstMfeStats 啟動擷取程式。
一般而言，若要擷取 MFE 統計數據，請先呼叫 MgmGetFirstMfeStats。 然後，呼叫 MgmGetNextMfeStats 一或多次，直到沒有更多要傳回的 MFE 為止。 每次呼叫 MgmGetNextMfeStats 時，都應該在上一次呼叫 MgmGetNextMfeStats 傳回的最後一個 MFE 之後開始 (或對 MgmGetFirstMfeStats 的初始呼叫) 若要這樣做，用戶端會指定先前呼叫所傳回緩衝區的最後一個來源和群組。
MFE 統計數據會在 dwFlags 參數所決定的MIB_IPMCAST_MFE_STATS或MIB_IPMCAST_MFE_STATS_EX結構中傳回。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | 都不支援 |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mgm.h |
| 程式庫 | Rtm.lib |
| Dll | Rtm.dll |