Función MgmTakeInterfaceOwnership (mgm.h)

  • Artículo

Un cliente llama a la función MgmTakeInterfaceOwnership (por ejemplo, un protocolo de enrutamiento) cuando está habilitada en una interfaz.

Solo un cliente puede tomar posesión de una interfaz determinada en cualquier momento. La única excepción a esta regla es igmp. IGMP puede coexistir con otro cliente en una interfaz.

Sintaxis

DWORD MgmTakeInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

Parámetros

[in] hProtocol

Controle el protocolo obtenido de una llamada anterior a MgmRegisterMProtocol.

[in] dwIfIndex

Especifica el índice de la interfaz de la que se va a tomar posesión.

[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. Algunos ejemplos de interfaces de punto a punto son 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.

Para las interfaces de difusión (como las interfaces Ethernet) o las interfaces de punto a punto, que solo se identifican mediante el valor de dwIfIndex, especifique cero.

Valor devuelto

Si la función se ejecuta 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_ALREADY_EXISTS
 La interfaz especificada ya es propiedad de otro protocolo de enrutamiento.
ERROR_CAN_NOT_COMPLETE
 No se pudo completar la llamada a esta función.
ERROR_INVALID_PARAMETER
 Identificador no válido para un cliente.
ERROR_NOT_ENOUGH_MEMORY
 No hay suficiente memoria para completar esta operación.
 
 

Comentarios

Un cliente debe tomar posesión de una interfaz solo después de registrarse con el administrador de grupos de multidifusión, pero antes de agregar entradas de pertenencia a grupos.

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

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership