Función MgmGetProtocolOnInterface (mgm.h)
La función MgmGetProtocolOnInterface recupera el identificador de protocolo del protocolo de enrutamiento de multidifusión que posee la interfaz especificada.
Sintaxis
DWORD MgmGetProtocolOnInterface(
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr,
[in, out] PDWORD pdwIfProtocolId,
[in, out] PDWORD pdwIfComponentId
);
Parámetros
[in] dwIfIndex
Especifica el índice de la interfaz para la que se va a recuperar el identificador de protocolo.
[in] dwIfNextHopAddr
Especifica la dirección del próximo salto que corresponde al índice especificado por dwIfIndex. Los parámetros dwIfIndex y dwIfNextHopIPAddr identifican de forma única un próximo salto en interfaces de punto a punto. Una interfaz de punto a punto es una conexión en la que una interfaz se conecta a varias redes. Entre los ejemplos de interfaces de punto a punto se incluyen interfaces de acceso múltiple (NBMA) que no son de difusión y la interfaz interna en la que se conectan todos los clientes de acceso telefónico.
En el caso de las interfaces de difusión (como interfaces Ethernet) o interfaces de punto a punto, que solo se identifican mediante el valor de dwIfIndex, especifique cero.
[in, out] pdwIfProtocolId
En la entrada, el cliente debe proporcionar un puntero a una ubicación de memoria de tamaño DWORD.
En la salida, pdwIfProtocolId recibe el identificador del protocolo en la interfaz especificada por dwIfIndex.
[in, out] pdwIfComponentId
En la entrada, el cliente debe proporcionar un puntero a un valor DWORD .
En la salida, pdwIfComponentId recibe el identificador de componente de la instancia del protocolo en la interfaz. Este parámetro se usa con pdwIfProtocolId para identificar de forma única una instancia de un protocolo de enrutamiento.
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 administrador del grupo de multidifusión no encontró la interfaz especificada. |
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 |