Función MgmReleaseInterfaceOwnership (mgm.h)

  • Artículo

Un cliente usa la función MgmReleaseInterfaceOwnership para renunciar a la propiedad de una interfaz. Cuando se llama a esta función, se eliminan todas las MFE mantenidas por el administrador del grupo de multidifusión en nombre del cliente y para la interfaz especificada.

Sintaxis

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

Parámetros

[in] hProtocol

Identificador del protocolo obtenido de una llamada anterior a MgmRegisterMProtocol.

[in] dwIfIndex

Especifica el índice de la interfaz que se va a liberar.

[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.

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_INVALID_PARAMETER
 No se encontró el identificador no válido para un cliente o la interfaz.
 
 

Comentarios

Un cliente debe liberar la propiedad de todas las interfaces que posee antes de anular el registro con la función MgmDeRegisterMProtocol .

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

MgmDeRegisterMProtocol

MgmTakeInterfaceOwnership