Funzione MgmGetMfeStats (mgm.h)

Articolo
08/24/2023

La funzione MgmGetMfeStats recupera le statistiche per un MFE specifico. Le statistiche restituite includono i pacchetti ricevuti, i byte ricevuti e i pacchetti inoltrati in ogni interfaccia in uscita.

Sintassi

DWORD MgmGetMfeStats(
  [in]      PMIB_IPMCAST_MFE pimm,
  [in, out] PDWORD           pdwBufferSize,
  [in, out] PBYTE            pbBuffer,
            DWORD            dwFlags
);

Parametri

[in] pimm

Puntatore a una struttura MIB_IPMCAST_MFE che specifica l'oggetto MFE per cui recuperare le statistiche. Le informazioni da restituire sono indicate dai membri dwSource e dwGroup della struttura MIB_IPMCAST_MFE.

[in, out] pdwBufferSize

In input , pdwBufferSize è un puntatore a un percorso di memoria di dimensioni DWORD contenente le dimensioni, in byte, del buffer a cui punta pbBuffer.

Nell'output, se il valore restituito è ERROR_INSUFFICIENT_BUFFER, pdwBufferSize riceve la dimensione minima a cui punta il buffer da pbBuffer deve essere per contenere il set di statistiche MFE; altrimenti il valore di pdwBufferSize rimane invariato.

[in, out] pbBuffer

In input, il client deve fornire un puntatore a un buffer.

Nell'output pbBuffer contiene il set specificato di statistiche MFE.

dwFlags

Determina la struttura dei dati restituita.

Valore	Significato
MGM_MFE_STATS_0	Includere le 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 è 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 le statistiche per anche un MFE. Il client deve controllare il valore di pdwBufferSize per la dimensione minima del buffer necessaria per recuperare le statistiche per un MFE.
ERROR_NOT_FOUND	L'oggetto MFE specificato non è stato trovato.

Commenti

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

Requisiti


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

MgmGetNextMfeStats

Condividi tramite