Share via

Funzione MgmReleaseInterfaceOwnership (mgm.h)

  • Articolo

La funzione MgmReleaseInterfaceOwnership viene usata da un client per rinunciare alla proprietà di un'interfaccia. Quando questa funzione viene chiamata, tutte le funzioni MFEs gestite dal gestore di gruppi multicast per conto del client e per l'interfaccia specificata vengono eliminate.

Sintassi

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

Parametri

[in] hProtocol

Gestire il protocollo ottenuto da una chiamata precedente a MgmRegisterMProtocol.

[in] dwIfIndex

Specifica l'indice dell'interfaccia da rilasciare.

[in] dwIfNextHopAddr

Specifica l'indirizzo dell'hop successivo che corrisponde all'indice specificato da dwIfIndex. I parametri dwIfIndex e dwIfNextHopIPAddr identificano in modo univoco un hop successivo sulle interfacce da punto a più punti. Un'interfaccia da punto a punto è una connessione in cui un'interfaccia si connette a più reti. Esempi di interfacce da punto a più punti includono interfacce di accesso multiplo (NBMA) non broadcast e l'interfaccia interna in cui si connettono tutti i client di connessione remota.

Per le interfacce di trasmissione (ad esempio interfacce Ethernet) o interfacce da punto a punto, identificate solo dal valore di dwIfIndex, specificano zero.

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_CAN_NOT_COMPLETE
 Impossibile completare la chiamata a questa funzione.
ERROR_INVALID_PARAMETER
 Handle non valido per un client oppure l'interfaccia non è stata trovata.
 
 

Commenti

Un client deve rilasciare la proprietà di tutte le interfacce di cui è proprietario prima di eseguire la registrazione con la funzione MgmDeRegisterMProtocol .

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