MgmGetNextMfe-Funktion (mgm.h)
Die MgmGetNextMfe-Funktion ruft mindestens ein MFEs ab. Der Routingtabellen-Manager beginnt mit dem Abrufen von MFEs beginnend mit der MFE, die der angegebenen MFE folgt. Die Funktion kann null, ein oder mehrere MFEs abrufen. Die Anzahl der zurückgegebenen MFEs hängt von der Größe der MFEs 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.
Syntax
DWORD MgmGetNextMfe(
[in] PMIB_IPMCAST_MFE pimmStart,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries
);
Parameter
[in] pimmStart
Zeiger auf eine MIB_IPMCAST_MFE-Struktur , die angibt, von wo aus mit dem Abrufen von MFEs 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 MgmGetFirstMfe oder MgmGetNextMfe 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 , die sein muss, um den MFE zu halten; 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 mindestens ein MFEs. Jede MFE ist eine MIB_IPMCAST_MFE 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 der mfEs, die in pbBuffer enthalten sind.
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 eine MFE zu klein. Der Client sollte den Wert von pdwBufferSize auf die minimale Puffergröße überprüfen, die zum Abrufen eines MFE erforderlich ist. |
|
Weitere MFEs sind verfügbar. |
|
Es sind keine mfEs mehr verfügbar. Null oder mehr MFEs wurden zurückgegeben; Überprüfen Sie den Wert von pdwNumEntries , um zu überprüfen, wie viele MFEs zurückgegeben wurden. |
Hinweise
Diese Funktion wird verwendet, um den sequenziellen Abruf von MFEs fortzusetzen. Verwenden Sie MgmGetFirstMfe , um den Abrufvorgang zu starten.
Im Allgemeinen rufen Sie zum Abrufen von MFEs zunächst MgmGetFirstMfe auf. Rufen Sie dann MgmGetNextMfe einmal oder mehrmals auf, bis keine mfEs mehr zurückgegeben werden können. Jeder Aufruf von MgmGetNextMfe sollte nach dem letzten MFE beginnen, der vom vorherigen Aufruf von MgmGetNextMfe (oder dem ersten Aufruf von MgmGetFirstMfe) zurückgegeben wurde. Dazu gibt der Client die letzte Quelle und Gruppe im Puffer an, die von einem vorherigen Aufruf zurückgegeben wurden.
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 |