Funzione MgmRegisterMProtocol (mgm.h)

Articolo
03/15/2023

La funzione MgmRegisterMProtocol viene usata dai client per la registrazione con gestione gruppi multicast. Al termine della registrazione, gestione gruppi multicast restituisce un handle al client. Il client deve fornire questo handle nelle successive chiamate di funzione MGM.

Sintassi

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

Parametri

[in] prpiInfo

Puntatore a una struttura ROUTING_PROTOCOL_CONFIG che contiene puntatori ai callback nel client.

[in] dwProtocolId

Specifica l'ID del client. L'ID è univoco per ogni client.

[in] dwComponentId

Specifica l'ID componente per un'istanza specifica del client. Questo parametro viene usato con dwProtocolId per identificare in modo univoco un'istanza di un client.

[out] phProtocol

All'input, il client deve fornire un puntatore a un handle.

Nell'output , phProtocol riceve l'handle di registrazione per il client. Questo handle deve essere usato nelle chiamate successive al gestore del gruppo multicast.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_ALREADY_EXISTS	Impossibile registrare il client specificato perché esiste già una voce con lo stesso ID protocollo e ID componente.
ERROR_CAN_NOT_COMPLETE	Impossibile completare la chiamata a questa funzione.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per completare questa operazione.

Commenti

La registrazione di un protocollo è la prima operazione che deve essere eseguita da qualsiasi protocollo di routing multicast. Dopo la registrazione, un protocollo di routing deve assumere la proprietà delle interfacce appropriate prima di aggiungere o eliminare le appartenenze ai gruppi.

Un solo protocollo di routing può assumere la proprietà di un'interfaccia in qualsiasi momento. È possibile registrare più protocolli di routing con gestione gruppi multicast, ognuno dei quali possiede interfacce diverse.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mgm.h
Libreria	Rtm.lib
DLL	Rtm.dll

Vedi anche

MgmDeRegisterMProtocol

MgmTakeInterfaceOwnership

ROUTING_PROTOCOL_CONFIG

Condividi tramite