MgmGetMfeStats-Funktion (mgm.h)
Die MgmGetMfeStats-Funktion ruft die Statistiken für eine bestimmte MFE ab. Die zurückgegebenen Statistiken umfassen die empfangenen Pakete, empfangene Bytes und die Pakete, die auf jeder ausgehenden Schnittstelle weitergeleitet werden.
Syntax
DWORD MgmGetMfeStats(
[in] PMIB_IPMCAST_MFE pimm,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
DWORD dwFlags
);
Parameter
[in] pimm
Zeiger auf eine MIB_IPMCAST_MFE-Struktur , die die MFE angibt, für die Statistiken abgerufen werden sollen. Die zurückzugebenden Informationen werden durch die dwSource- und dwGroup-Member der MIB_IPMCAST_MFE-Struktur angegeben.
[in, out] pdwBufferSize
Bei der Eingabe ist pdwBufferSize ein Zeiger auf einen Speicherort im DWORD-Format, der die Größe des Puffers in Byte enthält, auf den pbBuffer verweist.
Wenn der Rückgabewert ERROR_INSUFFICIENT_BUFFER ist, empfängt pdwBufferSize bei der Ausgabe die Mindestgröße, auf die der Puffer von pbBuffer verweist, um den Satz von MFE-Statistiken enthalten zu können. Andernfalls bleibt der Wert von pdwBufferSize unverändert.
[in, out] pbBuffer
Bei der Eingabe muss der Client einen Zeiger auf einen Puffer bereitstellen.
Bei der Ausgabe enthält pbBuffer den angegebenen Satz von MFE-Statistiken.
dwFlags
Bestimmt die zurückgegebene Datenstruktur.
| Wert | Bedeutung |
|---|---|
|
Schließen Sie Statistiken ein, die MIB_IPMCAST_MFE_STATS. |
|
Schließen Sie Statistiken ein, die MIB_IPMCAST_MFE_STATS_EX entsprechen. |
Rückgabewert
Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.
Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.
| Wert | Bedeutung |
|---|---|
|
Der Aufruf dieser Funktion konnte nicht abgeschlossen werden. |
|
Der angegebene Puffer ist für die Statistiken für auch nur eine MFE zu klein. Der Client sollte den Wert von pdwBufferSize auf die minimale Puffergröße überprüfen, die zum Abrufen von Statistiken für eine MFE erforderlich ist. |
|
Der angegebene MFE wurde nicht gefunden. |
Hinweise
Die MFE-Statistiken werden entweder in einer MIB_IPMCAST_MFE_STATS - oder MIB_IPMCAST_MFE_STATS_EX-Struktur zurückgegeben, die vom dwFlags-Parameter bestimmt wird.
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mgm.h |
| Bibliothek | Rtm.lib |
| DLL | Rtm.dll |