Funzione MgmGetNextMfeStats (mgm.h)

Articolo
02/29/2024

La funzione MgmGetNextMfeStats recupera uno o più set di statistiche MFE. Gestione tabelle di routing inizia a recuperare le statistiche a partire da MFE che segue l'mfe specificato. La funzione può recuperare zero, uno o più set di statistiche MFE. Il numero di set restituiti dipende dalle dimensioni delle voci e dalle dimensioni del buffer fornito dal client quando viene chiamata la funzione.

I dati restituiti nel buffer vengono ordinati prima per gruppo e quindi dalle origini all'interno di un gruppo. Le statistiche restituite includono i pacchetti ricevuti, i byte ricevuti e i pacchetti inoltrati in ogni interfaccia in uscita.

Sintassi

DWORD MgmGetNextMfeStats(
  [in]      PMIB_IPMCAST_MFE pimmStart,
  [in, out] PDWORD           pdwBufferSize,
  [in, out] PBYTE            pbBuffer,
  [in, out] PDWORD           pdwNumEntries,
            DWORD            dwFlags
);

Parametri

[in] pimmStart

Puntatore a una struttura MIB_IPMCAST_MFE che specifica da dove iniziare a recuperare le statistiche MFE. I membri dwSource e dwGroup della struttura MIB_IPMCAST_MFE identificano un MFE. Specificare l'origine e il gruppo dell'ultimo MFE restituito dalla chiamata precedente a MgmGetFirstMfeStats o MgmGetNextMfeStats.

[in, out] pdwBufferSize

In input pdwBufferSize è un puntatore a una posizione di memoria di dimensioni DWORD che contiene le dimensioni, in byte, di pbBuffer.

Nell'output, se il valore restituito è ERROR_INSUFFICIENT_BUFFER, pdwBufferSize riceve la dimensione minima pbBuffer deve contenere un set di statistiche MFE; in caso contrario, il valore di pdwBufferSize rimane invariato.

[in, out] pbBuffer

All'input, il client deve fornire un puntatore a un buffer.

Nell'output pbBuffer contiene uno o più set di statistiche MFE. Ogni set di statistiche MFE è una struttura MIB_IPMCAST_MFE_STATS .

[in, out] pdwNumEntries

All'input, il client deve fornire un puntatore a un percorso di memoria di dimensioni DWORD.

Nell'output pdwNumEntries riceve il numero di set di statistiche MFE contenute in pbBuffer.

dwFlags

Determina la struttura dei dati restituita.

Valore	Significato
MGM_MFE_STATS_0	Includere statistiche corrispondenti a MIB_IPMCAST_MFE_STATS.
MGM_MFE_STATS_1	Includere le statistiche corrispondenti a MIB_IPMCAST_MFE_STATS_EX.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_CAN_NOT_COMPLETE	Impossibile completare la chiamata a questa funzione.
ERROR_INSUFFICIENT_BUFFER	Il buffer specificato è troppo piccolo per un set di statistiche MFE. Il client deve controllare il valore di pdwBufferSize per la dimensione minima del buffer necessaria per recuperare un set di statistiche.
ERROR_MORE_DATA	Sono disponibili altre statistiche MFE.
ERROR_NO_MORE_ITEMS	Non sono disponibili altre statistiche MFE. Sono stati restituiti zero o più set di statistiche MFE; controllare il valore di pdwNumEntries per verificare il numero di set di statistiche restituiti.

Commenti

Questa funzione viene usata per continuare il recupero sequenziale delle statistiche MFE; usare MgmGetFirstMfeStats per avviare il processo di recupero.

In generale, per recuperare le statistiche MFE, chiamare prima MgmGetFirstMfeStats. Chiama quindi MgmGetNextMfeStats una o più volte, fino a quando non ci sono più MFE da restituire. Ogni chiamata a MgmGetNextMfeStats deve iniziare dopo l'ultimo MFE restituito dalla chiamata precedente a MgmGetNextMfeStats (o la chiamata iniziale a MgmGetFirstMfeStats) A tale scopo, il client specifica l'ultimo origine e il gruppo nel buffer restituito da una chiamata precedente.

Le statistiche MFE vengono restituite in una struttura MIB_IPMCAST_MFE_STATS o MIB_IPMCAST_MFE_STATS_EX determinata dal parametro dwFlags .

Nota La dimensione minima del buffer a cui punta pbBuffer non è fissa; è diverso per ogni set di statistiche MFE. Utilizzare la macro sizeof per determinare le dimensioni di ogni set di statistiche restituite nel buffer.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

MIB_IPMCAST_MFE_STATS

MIB_IPMCAST_MFE_STATS_EX

MgmGetFirstMfeStats

MgmGetMfeStats

Condividi tramite