Función MgmGetProtocolOnInterface (mgm.h)

  • Artículo

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
ERROR_CAN_NOT_COMPLETE
 No se pudo completar la llamada a esta función.
ERROR_NOT_FOUND
 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

Consulte también

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership