Funzione MgmGetNextMfe (mgm.h)

Articolo
02/29/2024

La funzione MgmGetNextMfe recupera uno o più MFEs. Gestione tabelle di routing avvia il recupero di MFE a partire da MFE che segue l'oggetto MFE specificato. La funzione può recuperare zero, uno o più MFEs. Il numero di MFEs restituiti dipende dalle dimensioni delle mfes 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.

Sintassi

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

Parametri

[in] pimmStart

Puntatore a una struttura MIB_IPMCAST_MFE che specifica da dove iniziare a recuperare le 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 MgmGetFirstMfe o MgmGetNextMfe.

[in, out] pdwBufferSize

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

Nell'output, se il valore restituito è ERROR_INSUFFICIENT_BUFFER, pdwBufferSize riceve la dimensione minima pbBuffer deve essere per contenere mfe; in caso contrario, il valore di pdwBufferSize rimane invariato.

[in, out] pbBuffer

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

Nell'output pbBuffer contiene uno o più MFEs. Ogni MFE è una struttura MIB_IPMCAST_MFE .

[in, out] pdwNumEntries

In input, il client deve fornire un puntatore a una posizione di memoria di dimensioni DWORD.

Nell'output, pdwNumEntries riceve il numero di MFEs contenuti in pbBuffer.

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 anche un MFE. Il client deve controllare il valore di pdwBufferSize per la dimensione minima del buffer necessaria per recuperare un MFE.
ERROR_MORE_DATA	Sono disponibili altre MFE.
ERROR_NO_MORE_ITEMS	Non sono disponibili più MFES. Zero o più MFES sono stati restituiti; controllare il valore di pdwNumEntries per verificare il numero di MFEs restituiti.

Commenti

Questa funzione viene usata per continuare il recupero sequenziale di MFES; usare MgmGetFirstMfe per avviare il processo di recupero.

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

Nota La dimensione minima del buffer a cui fa riferimento pbBuffer non è fissa; è diverso per ogni MFE. Utilizzare la macro sizeof(MIB_IPMCAST_MFE) per determinare le dimensioni di ogni MFE restituito 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

MgmGetFirstMfe

MgmGetMfe

Share via