Función MgmGetNextMfe (mgm.h)
La función MgmGetNextMfe recupera una o varias MFE. El administrador de tablas de enrutamiento comienza a recuperar las MFE a partir de la MFE que sigue a la MFE especificada. La función puede recuperar cero, una o varias MFE. El número de MME devueltos depende del tamaño de las MFE y del tamaño del búfer proporcionado por el cliente cuando se llama a la función.
Los datos devueltos en el búfer se ordenan primero por grupo y, a continuación, por los orígenes de un grupo.
Sintaxis
DWORD MgmGetNextMfe(
[in] PMIB_IPMCAST_MFE pimmStart,
[in, out] PDWORD pdwBufferSize,
[in, out] PBYTE pbBuffer,
[in, out] PDWORD pdwNumEntries
);
Parámetros
[in] pimmStart
Puntero a una estructura de MIB_IPMCAST_MFE que especifica desde dónde empezar a recuperar las MFP. Los miembros dwSource y dwGroup de la estructura MIB_IPMCAST_MFE identifican un MFE. Especifique el origen y el grupo de la última MFE que devolvió la llamada anterior a MgmGetFirstMfe o MgmGetNextMfe.
[in, out] pdwBufferSize
En la entrada, pdwBufferSize es un puntero a una ubicación de memoria de tamaño DWORD que contiene el tamaño, en bytes, de pbBuffer.
En la salida, si el valor devuelto es ERROR_INSUFFICIENT_BUFFER, pdwBufferSize recibe el tamaño mínimo pbBuffer debe ser para contener el MFE; de lo contrario, el valor de pdwBufferSize permanece sin cambios.
[in, out] pbBuffer
En la entrada, el cliente debe proporcionar un puntero a un búfer.
En la salida, pbBuffer contiene una o varias MFP. Cada MFE es una estructura MIB_IPMCAST_MFE .
[in, out] pdwNumEntries
En la entrada, el cliente debe proporcionar un puntero a una ubicación de memoria de tamaño DWORD.
En la salida, pdwNumEntries recibe el número de MFE contenidos en pbBuffer.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es NO_ERROR.
Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.
| Valor | Significado |
|---|---|
|
No se pudo completar la llamada a esta función. |
|
El búfer especificado es demasiado pequeño para incluso una MFE. El cliente debe comprobar el valor de pdwBufferSize para el tamaño mínimo del búfer necesario para recuperar una MFE. |
|
Hay más MFE disponibles. |
|
No hay más MFE disponibles. Se devolvieron cero o más MFE; compruebe el valor de pdwNumEntries para comprobar cuántos MFP se devolvieron. |
Comentarios
Esta función se utiliza para continuar con la recuperación secuencial de las MFE; use MgmGetFirstMfe para iniciar el proceso de recuperación.
En general, para recuperar las MFE, llame primero a MgmGetFirstMfe. A continuación, llame a MgmGetNextMfe una o varias veces, hasta que no haya más MFE para devolver. Cada llamada a MgmGetNextMfe debe comenzar después de la última MFE devuelta por la llamada anterior a MgmGetNextMfe (o la llamada inicial a MgmGetFirstMfe). Para ello, el cliente especifica el último origen y grupo del búfer devuelto por una llamada anterior.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | mgm.h |
| Library | Rtm.lib |
| Archivo DLL | Rtm.dll |