MgmGetNextMfeStats-Funktion (mgm.h)
Die MgmGetNextMfeStats-Funktion ruft mindestens einen Satz von MFE-Statistiken ab. Der Routingtabellen-Manager beginnt mit dem Abrufen von Statistiken, beginnend mit der MFE, die der angegebenen MFE folgt. Die Funktion kann 0, einen oder mehrere Sätze von MFE-Statistiken abrufen. Die Anzahl der zurückgegebenen Mengen hängt von der Größe der Einträge und der Größe des Puffers ab, der vom Client beim Aufrufen der Funktion bereitgestellt wird.
Die im Puffer zurückgegebenen Daten werden zuerst nach Gruppe und dann nach den Quellen innerhalb einer Gruppe sortiert. Die zurückgegebenen Statistiken umfassen die empfangenen Pakete, empfangene Bytes und pakete, die auf jeder ausgehenden Schnittstelle weitergeleitet werden.
Syntax
DWORD MgmGetNextMfeStats(
[in] PMIB_IPMCAST_MFE pimmStart,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries,
DWORD dwFlags
);
Parameter
[in] pimmStart
Zeiger auf eine MIB_IPMCAST_MFE-Struktur , die angibt, von wo aus mit dem Abrufen von MFE-Statistiken begonnen werden soll. Die dwSource- und dwGroup-Member der MIB_IPMCAST_MFE Struktur identifizieren eine MFE. Geben Sie die Quelle und Gruppe der letzten MFE an, die vom vorherigen Aufruf von MgmGetFirstMfeStats oder MgmGetNextMfeStats zurückgegeben wurde.
[in, out] pdwBufferSize
Bei der Eingabe ist pdwBufferSize ein Zeiger auf einen Speicherort im DWORD-Format, der die Größe von pbBuffer in Bytes enthält.
Wenn der Rückgabewert bei der Ausgabe ERROR_INSUFFICIENT_BUFFER ist, empfängt pdwBufferSize die Mindestgröße pbBuffer muss sein, um eine Reihe von MFE-Statistiken zu enthalten. Andernfalls bleibt der Wert von pdwBufferSize unverändert.
[in, out] pbBuffer
Bei der Eingabe muss der Client einen Zeiger auf einen Puffer bereitstellen.
PbBuffer enthält bei der Ausgabe eine oder mehrere Sätze von MFE-Statistiken. Jeder Satz von MFE-Statistiken ist eine MIB_IPMCAST_MFE_STATS-Struktur .
[in, out] pdwNumEntries
Bei der Eingabe muss der Client einen Zeiger auf einen Speicherort im DWORD-Format bereitstellen.
Bei der Ausgabe empfängt pdwNumEntries die Anzahl von Sätzen von MFE-Statistiken, die in pbBuffer enthalten sind.
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 zu klein für selbst einen Satz von MFE-Statistiken. Der Client sollte den Wert von pdwBufferSize auf die minimale Puffergröße überprüfen, die zum Abrufen eines Statistiksatzes erforderlich ist. |
|
Weitere MFE-Statistiken sind verfügbar. |
|
Es sind keine MFE-Statistiken mehr verfügbar. Es wurden 0 oder mehr Sätze von MFE-Statistiken zurückgegeben; Überprüfen Sie den Wert von pdwNumEntries , um zu überprüfen, wie viele Sätze von Statistiken zurückgegeben wurden. |
Hinweise
Diese Funktion wird verwendet, um den sequenziellen Abruf von MFE-Statistiken fortzusetzen. Verwenden Sie MgmGetFirstMfeStats , um den Abrufvorgang zu starten.
Im Allgemeinen rufen Sie zum Abrufen von MFE-Statistiken zunächst MgmGetFirstMfeStats auf. Rufen Sie dann MgmGetNextMfeStats einmal oder mehrmals auf, bis keine mfEs mehr zurückgegeben werden können. Jeder Aufruf von MgmGetNextMfeStats sollte nach dem letzten MFE beginnen, der vom vorherigen Aufruf von MgmGetNextMfeStats (oder dem ersten Aufruf von MgmGetFirstMfeStats) zurückgegeben wurde. Dazu gibt der Client die letzte Quelle und Gruppe im Puffer an, die von einem vorherigen Aufruf zurückgegeben wurden.
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
| Anforderung | Wert |
|---|---|
| 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 |