Funzione MgmTakeInterfaceOwnership (mgm.h)

Articolo
03/15/2023

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

Condividi tramite