Función MgmRegisterMProtocol (mgm.h)

Los clientes usan la función MgmRegisterMProtocol para registrarse con el administrador del grupo de multidifusión. Una vez completado el registro, el administrador de grupos de multidifusión devuelve un identificador al cliente. El cliente debe proporcionar este identificador en las llamadas de función MGM posteriores.

Sintaxis

DWORD MgmRegisterMProtocol(
  [in]  PROUTING_PROTOCOL_CONFIG prpiInfo,
  [in]  DWORD                    dwProtocolId,
  [in]  DWORD                    dwComponentId,
  [out] HANDLE                   *phProtocol
);

Parámetros

[in] prpiInfo

Puntero a una estructura de ROUTING_PROTOCOL_CONFIG que contiene punteros a devoluciones de llamada en el cliente.

[in] dwProtocolId

Especifica el identificador del cliente. El identificador es único para cada cliente.

[in] dwComponentId

Especifica el identificador de componente de una instancia específica del cliente. Este parámetro se usa con dwProtocolId para identificar de forma única una instancia de un cliente.

[out] phProtocol

En la entrada, el cliente debe proporcionar un puntero a un identificador.

En la salida, phProtocol recibe el identificador de registro del cliente. Este identificador se debe usar en llamadas posteriores al administrador de grupos de multidifusión.

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	No se puede registrar el cliente especificado porque ya existe una entrada con el mismo identificador de protocolo y identificador de componente.
ERROR_CAN_NOT_COMPLETE	No se pudo completar la llamada a esta función.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria para completar esta operación.

 

 

Comentarios

El registro de un protocolo es la primera operación que debe realizar cualquier protocolo de enrutamiento de multidifusión. Después del registro, un protocolo de enrutamiento debe tomar posesión de las interfaces adecuadas antes de agregar o eliminar pertenencias a grupos.

Solo un protocolo de enrutamiento puede tomar posesión de una interfaz en un momento dado. Se pueden registrar varios protocolos de enrutamiento con el administrador de grupos de multidifusión, cada protocolo que posee interfaces diferentes.

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

ROUTING_PROTOCOL_CONFIG