Share via

Funzione MgmTakeInterfaceOwnership (mgm.h)

  • Articolo

La funzione MgmTakeInterfaceOwnership viene chiamata da un client (ad esempio un protocollo di routing) quando è abilitata in un'interfaccia.

Solo un client può assumere la proprietà di un'interfaccia specifica in qualsiasi momento. L'unica eccezione a questa regola è IGMP. IGMP può coesistere con un altro client in un'interfaccia.

Sintassi

DWORD MgmTakeInterfaceOwnership(
  [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 di cui acquisire la proprietà.

[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 su interfacce da punto a più punti. Un'interfaccia da punto a più punti è una connessione in cui un'interfaccia si connette a più reti. Esempi di interfacce da punto a più punti includono interfacce di accesso non broadcast (NBMA) e l'interfaccia interna in cui si connettono tutti i client di accesso esterno.

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

Valore restituito

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

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

Valore Significato
ERROR_ALREADY_EXISTS
 L'interfaccia specificata è già di proprietà di un altro protocollo di routing.
ERROR_CAN_NOT_COMPLETE
 Impossibile completare la chiamata a questa funzione.
ERROR_INVALID_PARAMETER
 Handle non valido per un client.
ERROR_NOT_ENOUGH_MEMORY
 Memoria insufficiente per completare questa operazione.
 
 

Commenti

Un client deve assumere la proprietà di un'interfaccia solo dopo la registrazione con gestione gruppi multicast, ma prima di aggiungere voci di appartenenza al gruppo.

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

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership